home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / dfue / term 4.6(?) / term.doc < prev    next >
Text File  |  1996-03-18  |  400KB  |  9,622 lines
  1.    `term' 4.6 - A terminal program for Amiga computers
  2.  
  3.    Copyright © 1990-1996 Olaf Barthel
  4.  
  5.    You may make and distribute verbatim copies of this documentation if
  6. the contents are unchanged or the author has agreed to any changes made.
  7.  
  8.    No guarantee of any kind is given that the program described in this
  9. document are 100% reliable. You are using this material on your own
  10. risk.
  11.  
  12.    The program `term' and the data received/sent by it must not be used
  13. for the following purposes:
  14.  
  15.   1. The construction, development, production or testing of weapons or
  16.      weapon systems of any kind.
  17.  
  18.   2. The construction, development, production or use of
  19.      plants/installations which include the processing of
  20.      radioactive/fissionable material.
  21.  
  22.   3. The training of persons to deal with the abovesaid actions.
  23.  
  24.  
  25.    Listen to your conscience.
  26.  
  27. Introduction
  28. ************
  29.  
  30.    `term' is a telecommuncations program designed for use with any
  31. Commodore-Amiga computer running Kickstart 2.04 or higher. Its features
  32. include
  33.  
  34.    * Fast built-in VT220 terminal emulation
  35.  
  36.    * Support for custom terminal emulation modules following the `XEM
  37.      2.0' standard
  38.  
  39.    * Operates in any display environment, supports all screen display
  40.      modes
  41.  
  42.    * Support for file transfer modules following the `XPR' standard
  43.  
  44.    * File- and printer-capturing functions
  45.  
  46.    * Review-buffer support
  47.  
  48.    * Powerful phonebook and dialing functions
  49.  
  50.    * `Amiga User Interface Style Guide' conformant user interface
  51.  
  52.    * Online-help (requires AmigaGuide package)
  53.  
  54.    * Built-in `ARexx' interface
  55.  
  56.    * File upload list, which permits selecting the files to be
  57.      transferred before the upload is started.
  58.  
  59.    * Login script learn mode.
  60.  
  61.    * Built-in keyword/response parser which makes it possible to have
  62.      `term' respond to BBS prompts and such with the user name,
  63.      password, etc. without having to program the ARexx interface.
  64.  
  65.    * Interface for external programs to rendezvous with `term', taking
  66.      over serial I/O processing (such as `HydraCom').
  67.  
  68.    Although this program is freely-distributable, it is not entirely
  69. free.  If you like it and use frequently, you are requested to send the
  70. author a donation which you suppose will do as a payment for the
  71. program.  See the chapter registration (see Registration) for details.
  72.  
  73.    Admittedly, `term' is a fairly large program which consumes quite an
  74. amount of memory when running. You need to have at least 2 MBytes of
  75. system memory installed if you wish to run the program. Please note
  76. that this is the bare minimum configuration. It is recommended that you
  77. run `term' on a faster machine, i.e. plain MC68000-driven Amigas will
  78. have trouble running the program.
  79.  
  80. Registration
  81. ************
  82.  
  83.    `term' is made available under the concept of Gift-Ware, which is a
  84. variant of Share-Ware. Share-Ware software authors often release
  85. `crippled' versions of their products, i.e. these programs do not
  86. support the same functionality as the registered versions you get when
  87. sending monetary contributions to the authors. It all comes down to
  88. `pay for the software you are using' in Share-Ware terms. With
  89. Gift-Ware registration is different, you are not required to contribute
  90. money, but a gift will do. With `term' you always get a fully
  91. functional program, there is no `crippled' test release which you can
  92. try for a limited time and then have to pay for in order to receive the
  93. working registered version.
  94.  
  95.    It may seem as if `term' was free, but this is not the case.
  96. Although there is no need to pay the author in order to get a fully
  97. functional version of the program you should consider making a
  98. contribution. You don't need to feel guilty if you cannot or do not
  99. want to give me something in return for the work I have put into
  100. `term'. Show me that it was worth spending so much time listening to
  101. users, updating, rewriting and enhancing this program. Your
  102. contributions will provide the motivation for me to keep developing the
  103. program.
  104.  
  105.    One method of `payment' would be to order the `Olsen Opals' CD-ROM.
  106. This CD contains almost every program I have written for the Amiga in
  107. the last seven years. The CD can be bought for US$ 35 directly from me
  108. or from your local software distributor.
  109.  
  110.    If you don't have any CD-ROM drive or just don't want to buy the CD,
  111. here is a list of suggested contributions:
  112.  
  113.    * An old Cinemaware game (`Rocket Ranger', `Sinbad and the Throne of
  114.      the Falcon', `SDI', `It came from the Desert II')
  115.  
  116.    * An old game by Activision (`Tass Times in Tonetown')
  117.  
  118.    * An old Electronic Arts program (`The Bard's Tale II: The Destiny
  119.      Knight', `The Bard's Tale III: The Thief of Fate', `Instant
  120.      Music', `Zany Golf', `The Immortal', `Deluxe Paint', `Deluxe
  121.      Print', `Deluxe Music Construction Set', `Deluxe Video')
  122.  
  123.    * An old Rainbird or Firebird game (`Starglider I ', `Jewels of
  124.      Darkness', `Black Lamp')
  125.  
  126.    * Infocom games and Infocom hintbooks. Although I already own almost
  127.      all games published in `The Lost Treasures of Infocom vol I+II' I
  128.      still collect the originals (not those super-cheap Virgin Software
  129.      re-releases). With the exception of `A Mind forever voyaging',
  130.      `Arthur', `Hollywood Hijinx', `Infidel', `Leather Goddesses of
  131.      Phobos', `Nord and Bert couldn't make head or tail of it',
  132.      `Plundered Hearts', `Shogun', `Spellbreaker', `Suspect', `The
  133.      Lurking Horror', `Trinity', `Wishbringer', `Zork I', `Zork Zero'
  134.      (which I already own) I welcome any game in any format - it does
  135.      not necessarily have to be an Amiga game, Apple II, Kaypro,
  136.      Atari-XL, C64, etc. will be fine, too.
  137.  
  138.    * An old Telarium/Trillium game for the C64 on 5.25" floppy disk
  139.      (such as `The Amazon', `Rendezvous with Rama', `Fahrenheit 451').
  140.  
  141.    * An old Lucasfilm game for the C64 on 5.25" floppy disk (such as
  142.      `Rescue on Fractalus', `Ballblazer'). Please send only the PAL
  143.      versions as the original American program versions were tuned for
  144.      NTSC machines.
  145.  
  146.    * Scenery disks for the SubLogic Flight-Simulator II - except for
  147.      `Western European Tour', `Hawaiian Scenery Adventure', `Japan',
  148.      `USA #7', `USA #9', `USA #11' and `USA #14'.
  149.  
  150.    * The films `City Slickers', `Jabberwocky', `Brazil', `The Fisher
  151.      King', `Time Bandits', `Annie Hall', `Zelig' or `Alien' on a
  152.      PAL-VHS video cassette
  153.  
  154.    * A CD by the Beatles (specifically, `Please please me', `With the
  155.      Beatles' aka `Meet the Beatles', `Beatles for sale' or `Past
  156.      Masters Vol. 1'),  Little Feat (-1989), Weather Report, Paul Simon
  157.      (1971-1985), Eric Clapton (-1985), Peter Gabriel (1977-1989), Van
  158.      Morrison or Daniel Lanois
  159.  
  160.    * A book by Michael Crichton, Bruce Chatwin, Raymond Chandler, Terry
  161.      Pratchett or Steven Meretzky
  162.  
  163.    * Cash and checks (no credit cards - sorry) are always welcome.
  164.  
  165.    Send your contribution to the following address:
  166.  
  167.                              Olaf Barthel
  168.  
  169.                            Brabeckstrasse 35
  170.  
  171.                            D-30559 Hannover
  172.  
  173.                       Federal Republic of Germany
  174.  
  175.    If you wish to be notified when program updates become available or
  176. wish to order the next update as it becomes available you must include
  177. enough money to cover my expenses, see the chapter entitled orders (see
  178. Orders) for more information.
  179.  
  180. Commercial distribution
  181. ***********************
  182.  
  183.    I don't mind if you make a copy of `term' for a customer who is
  184. looking for a decent terminal program. But if you decide to distribute
  185. the program on a larger scale, such as by including a copy with each
  186. modem you sell, I want to know about it. The reason is this: by
  187. distributing `term' you take a certain responsability; if your customer
  188. has difficulties in installing and configuring the program she/he will
  189. most likely ask you for assistance. I want to make sure that if a
  190. `term' user is in bad need of help there is somebody who will be able
  191. to provide it. If you wish to become a `term' distributor and want your
  192. name displayed in the `About' window, contact me for details.
  193.  
  194.    As a general rule, no profit must be made by distributing `term',
  195. i.e. you may charge fees for copying, disks and for providing a printed
  196. manual but no money must be charged for the software itself. I consider
  197. taking legal actions against anyone who violates this rule. Payments
  198. for using the program should be made to the author, not to the provider.
  199.  
  200. Orders
  201. ******
  202.  
  203.    You can order a copy via standard mail by sending a self-addressed
  204. envelope, including postage and disks (more on this below) to the
  205. following address:
  206.  
  207.                              Olaf Barthel
  208.  
  209.                            Brabeckstrasse 35
  210.  
  211.                            D-30559 Hannover
  212.  
  213.                       Federal Republic of Germany
  214.  
  215.    Either include three 3.5" double-density disks or two 3.5"
  216. high-density disks. The postage must cover the mailing costs, this
  217. should be the equivalent to DM 8,- in your preferred currency for
  218. Europe, and DM 16,- for all other countries. All orders are shipped via
  219. air mail. If you cannot provide the disks and the envelope, add DM 1,50
  220. per double-density disk or DM 3,- per high-density disk and DM 2,- for
  221. a padded envelope. If you send a check to cover my expenses, please
  222. make sure that the fee I have to pay for cashing it (which currently is
  223. DM 3,-) does not `eat up' the mailing costs.
  224.  
  225.    As of this writing I do not distribute printed copies of the
  226. documentation.
  227.  
  228.    Orders must be made by mail only, not by phone or eMail.
  229.  
  230.    Whenever a new release of `term' becomes available I will try to
  231. make it known in the telecommunications networks.
  232.  
  233.    The most current `term' release will be available through ftp from
  234. all Aminet sites, such as `ftp.wustl.edu [128.252.135.4]'.  Look into
  235. the `pub/aminet/comm/term' directory.
  236.  
  237.    `term' is available for download in a number of BBSes. *Careful
  238. please!* For reasons I have always failed to understand certain
  239. individuals take pride in patching program version numbers, copying
  240. archives to disk and compressing them into .DMS files, attach silly
  241. notes to archives or extract single files from archives, just to
  242. recompress and release them later. *Hands off these files!* `term' is
  243. always distributed only in complete LhA-archives, never as a single
  244. program or as a .DMS-file.  In addition to this file lists and
  245. signatures generated using the PGP program provide authenticity. If any
  246. of these signs are missing chances are that you have found a corrupted
  247. copy which most likely was not released by me. My public key can be
  248. found in the chapter PGP key (see PGP key).
  249.  
  250.    I will not distribute `term' via eMail, the program is too large to
  251. be mailed and since I am paying both for incoming and outgoing mail it
  252. would also be too expensive for me.
  253.  
  254.    Unless requested, no update notifications will be sent via standard
  255. mail. I recommend that you include an international reply coupon for
  256. each update notification you wish to receive.
  257.  
  258.    The author reserves the right to discontinue development of the
  259. `term' program.
  260.  
  261. Letters to the author
  262. *********************
  263.  
  264.    It is always nice to receive feedback from users, to hear about
  265. critical comments and enhancement request. If you wish to communicate
  266. with me I suggest that you try electronic mail channels first. As of
  267. this writing there only exists a single Internet address
  268. (`olsen@sourcery.han.de') you can send mail to. I have no Fidonet
  269. accounts or such, in fact I don't even visit any BBSes regularly. If
  270. you need to put a mail through to me and don't have direct Internet
  271. access it is recommended that you use the gateway facilities most nets
  272. offer, your local sysop or postmaster will be able to tell you more. Do
  273. not send mail larger than about 64K bytes, as it may get caught on the
  274. way to me and if it in facts arrives in my mail folder it will have cost
  275. me routing fees since I pay both for my incoming and my outgoing mail.
  276. Please don't expect me to make long-distance calls to your local BBS,
  277. German phone rates are rather steep and I am not that wealthy after all.
  278.  
  279.    If you happen to be registered in a BBS which has no links to any
  280. net or if you don't have any email access at all the only alternative
  281. to dropping by and paying me a visit in person is to use the standard
  282. mail facilities: send a letter, mail a package.  Although such mail
  283. will usually arrive safely and unharmed there still is a problem: I am
  284. slow at responding to `real-world mail'.  If a letter can be answered
  285. with a few lines of text chances are good for a snappy answer, but if
  286. the topic is a little more complex your letter may go into my mail
  287. service stack. To give you an impression how this stack looks like:
  288. it's a large pile of unanswered mail sitting on my desk which keeps
  289. falling over each time I open the window. Such mail will usually get
  290. answered at the end of the semester or when my bad conscience tells me
  291. to.
  292.  
  293.    Be sure to mention it if you want me to send you an update to `term'
  294. or the most recent version of the program and include some money to
  295. cover my expenses. If you want me to help you or to give advice please
  296. keep in mind that even though there is no denying the fact that I have
  297. written `term' I am by no means an expert in telecommuncations matters.
  298. So if you need to know which modem brand to choose or which Bulgarian
  299. BBSes are worth trying I strongly suggest that you ask someone else.
  300.  
  301.    In any case, feel free to make comments and to ask questions.
  302.  
  303. Known bugs & problems
  304. *********************
  305.  
  306.    During beta testing certain software did not work very well with
  307. `term' (nothing serious I would say, but you may have a different
  308. opinion). There are also a few problems that would show up at the last
  309. minute (and at great expense) when it was too late to find a fix. Last
  310. but not least the following list also includes a few `features' for
  311. which I was unable to find a better solution.
  312.  
  313.    * With `MagicMenu' running in the background the checkmark and Amiga
  314.      symbols overwrite some menu entries.
  315.  
  316.      Older versions of `MagicMenu' do not notice that `term' scales
  317.      these symbols to fit the current screen display aspect ratio.
  318.      Recent versions of `MagicMenu' address this problem.
  319.  
  320.    * Not all the buttons in the file transfer window do what their
  321.      labels say.
  322.  
  323.      The XPR library running the file transfer is responsible for
  324.      listening to the commands `term' sends to it when the `Stop entire
  325.      transfer', `Skip current file' and `Stop transfer batch' buttons
  326.      are pressed. Not all libraries will pay attention to these
  327.      commands.  So far only `xprkermit.library' responds to all
  328.      commands. The `xprzmodem.library' included in the `term'
  329.      distribution will ignore the `Stop transfer batch' command. All
  330.      other XPR libraries either treat all buttons the same way, i.e.
  331.      they stop the transfer no matter which button is pressed, or just
  332.      pay attention to the `Stop entire transfer' command.
  333.  
  334. Frequently asked questions
  335. **************************
  336.  
  337.    This section was written in order to answer the most frequently
  338. asked questions concerning `term'. Although I don't suppose that the
  339. users who this section was intended for will really ready it, but it may
  340. nevertheless still be quite useful. Each entry in the following list
  341. explains why a particular feature works this way or the other and
  342. possibly why.
  343.  
  344.   1. While scrolling `term' quietly swallows characters and sometimes
  345.      whole lines.
  346.  
  347.      Usually, `term' cannot process incoming serial data while the
  348.      terminal output processing is taking place. If output processing
  349.      takes too much time you may end up losing incoming data. There are
  350.      several way how to approach this problem. You could reduce the
  351.      number of colours used for screen output, or enable the terminal
  352.      emulation process via the `Enable emulation process' switch in the
  353.      section entitled terminal panel (see Terminal panel).
  354.  
  355.   2. Right after a connection is established the modem hangs up the
  356.      line.
  357.  
  358.      Following your configuration options `term' makes sure that the
  359.      modem is set up correctly prior to making a call. Does the modem
  360.      drop the line right after the `CONNECT' message is received your
  361.      modem or the remote modem may reponsible. Not unheard of are
  362.      modems which due to firmware trouble fail to negotiate correctly
  363.      with the remote modem over the transmission protocol to be used.
  364.      With error correction enabled such modems would drop the line right
  365.      after establishing the connection. Turning off the error
  366.      correction mode would correct this problem. `term' cannot do
  367.      anything about the modem behaviour, it is up to you to find the
  368.      correct setup.
  369.  
  370.   3. Trying to run the modem at higher baud rates causes the modem to
  371.      ignore commands, it does not even echo characters back.
  372.  
  373.      A number of modems respond only to a fixed set of baud rates. While
  374.      for example 9,600 bps are fine there is no response at 14,400 bps.
  375.      I suggest that you try all available baud rates `term' supports
  376.      until one is found to fit. Do not overdo it however, try to keep
  377.      the baud rate below 57,600 bps.
  378.  
  379.   4. During file transfers error #6 is reported over and over again.
  380.  
  381.      Data transfer to and from the serial hardware is a time requires
  382.      quick responses by the handler routines, this is why interrupt
  383.      processing is used for such time-critical jobs. Unfortunately,
  384.      these interrupts cannot always be serviced as fast as possible.
  385.      Read and write accesses to disk may temporarily slow interrupt
  386.      processing down or even disable it in short intervals. If the
  387.      send/receive buffers keep flowing over I suggest that you use a
  388.      smaller file buffer size, so data gets written to disk in smaller
  389.      chunks, making the intervals smaller in which interrupt processing
  390.      may be affected.  You can change the default file buffer size in
  391.      the miscellaneous settings (see Miscellaneous panel). If this
  392.      still does not have the desired effect, turn on the switch `Simple
  393.      file I/O' (see Miscellaneous panel) and change the buffer size of
  394.      the file transfer protocol you are using. Start with a small
  395.      buffer size, such as 4,096 bytes and gradually increase it as long
  396.      as transfers still work correctly.
  397.  
  398.   5. I have saved the phonebook and the configuration files to disk and
  399.      an older `term' release reports that it cannot read them.
  400.  
  401.      `term' stores version information with the configuration files it
  402.      saves. Older `term' releases will refuse to read files created by
  403.      newer releases. Newer releases will almost always read
  404.      configuration files by older `term' releases.
  405.  
  406.   6. I upgraded from an older `term' release, but the program refuses
  407.      to read my configuration and phonebook files.
  408.  
  409.      The phonebook and configuration file format was changed and
  410.      greatly enhanced with the introduction of `term' 3.1. Older files
  411.      need to be converted to the new format, this is what the
  412.      `UpdateConfig' program is for that should be included in the
  413.      `term' distribution. The conversion is easy, just enter
  414.      `UpdateConfig <old file name> <new file name>', the program
  415.      automatically determines whether it is reading a configuration or
  416.      a phonebook file.
  417.  
  418.      *Caution: the conversion program cannot read encrypted phonebook
  419.      files, so they should be saved in unencrypted form first.*
  420.  
  421.   7. In some BBSes ANSI graphics and text output starts at the wrong
  422.      screen position, especially after the screen contents are erased.
  423.  
  424.      The so-called BBS-ANSI terminal command set treats the `clear
  425.      screen command' different from the VT100 specs, i.e. it expects
  426.      the cursor to be reset to the home position. You can enable this
  427.      feature using the `CLS' resets cursor position' switch which can
  428.      be found in the emulation panel (see Emulation panel).
  429.  
  430.   8. The text buffer window does not show any special characters, such
  431.      as accented characters, but only dots (`.').
  432.  
  433.      The text buffer window cannot display characters which fall into
  434.      the range between code #127 and code #159. In order to show any
  435.      text at all these codes get replaced by the dot character.
  436.  
  437.   9. When I upgraded from an older program release (1.6 - 2.3) to the
  438.      new `term' release the program would no longer find all its
  439.      configuration files.
  440.  
  441.      In order to annoy you and make things generally irritating some of
  442.      the configuration files were renamed in v2.4, and some were moved
  443.      to different directories. While the files used to be present in
  444.      `ENVARC:term' `term' now looks for them in `TERM:config'.  If
  445.      `term' finds no `TERM:' assignments, it will create one. If no
  446.      `TERM:config' drawer can be found, it will also be created.  The
  447.      configuration files have been changed as follows:
  448.  
  449.     `Preferences.term'
  450.     `term_preferences.iff'
  451.           New name is now `term.prefs'
  452.  
  453.     `Phonebook.term'
  454.     `term_phonebook.iff'
  455.           New name is now `phonebook.prefs'
  456.  
  457.     `Hotkeys.term'
  458.     `term_hotkeys.iff'
  459.           New name is now `hotkeys.prefs'
  460.  
  461.     `Speech.term'
  462.     `term_speech.iff'
  463.           New name is now `speech.prefs'
  464.  
  465.     `Macros.term'
  466.     `term_macros.iff'
  467.     `macros.prefs'
  468.           New name is now `functionkeys.prefs'
  469.  
  470.     `Fast!Macros.term'
  471.     `term_fastmacros.iff'
  472.           New name is now `fastmacros.prefs'
  473.  
  474.      In order to use `term' and `termcap' you need to rename the
  475.      `TERMPATH' variable to `TERMCONFIGPATH'. Look into the `ENVARC:'
  476.      drawer, rename the file and reboot.
  477.  
  478.      *Caution: it is not sufficient just to rename the file names, you
  479.      will also have to take care of the phonebook entries.*
  480.  
  481.  10. I have added several phone numbers to the quick dial menu, but
  482.      `term' does not make them all available.
  483.  
  484.      `term' has room for only up to 50 quick dial entries, any further
  485.      entries will be ignore.
  486.  
  487.  11. When transferring files between computers connected via null-modem
  488.      cables the transfer always aborts immediately complaining that the
  489.      DTR or the carrier signal was lost.
  490.  
  491.      During a null-modem transfer there is no carrier or DTR signals
  492.      present, only modems and such offer such features. Switch the
  493.      handshaking mode to `None' and turn off the `Check carrier' feature
  494.      in the serial panel (see Serial panel).
  495.  
  496.  12. The dialer skips two entries at once when pressing the `Skip'
  497.      button.
  498.  
  499.      Pressing the `Skip' button stops dialing, most modems will respond
  500.      to this with an `OK' message. Some modems will however send `NO
  501.      CARRIER', which `term' interpretes the same way as if `BUSY' had
  502.      been sent. If this is what your modem does, change the `Treat `NO
  503.      CARRIER' as `BUSY'' switch in the Serial panel (see Serial panel).
  504.  
  505.  13. During ZModem file transfers using a fast modem the `CPS' display
  506.      first lists an incredibly high value, then drops sharply, followed
  507.      by lots and lots of transfer errors occuring.
  508.  
  509.      This is effect is mostly seen if the `Handshaking' mode is not set
  510.      to `RTS/CTS' when using a fast modem. The trouble is caused by
  511.      data getting sent while the modem has already stopped accepting
  512.      new data. It flags this states using the RTS/CTS line.
  513.  
  514.  14. None of my ARexx scripts works any more.
  515.  
  516.      In v3.1 the `term' ARexx interface was rewritten from scratch. If
  517.      you wish to retain your old ARexx scripts they will need to be
  518.      rewritten.
  519.  
  520.  15. During file transfers errors show up while data is saved to and
  521.      read from a hard disk drive.
  522.  
  523.      Some hard disk drive controllers temporarily disable interrupt
  524.      processing while accesses take place. In such cases I recommend to
  525.      download and upload from the ram disk or to upgrade the hard disk
  526.      driver.
  527.  
  528.  16. Even though the speech support feature is enabled, `term' does not
  529.      speak a single word.
  530.  
  531.      With the introduction of Workbench 2.1 Commodore ceased to support
  532.      the speech synthesizer. If you don't have `narrator.device' and
  533.      `translator.library' installed the speech support will not work.
  534.  
  535.  17. When downloading files they don't end up in the right drawer.
  536.  
  537.      The file transfer protocol usually has it's own opinion on where to
  538.      place files it receives. This behaviour can be changed by editing
  539.      the `term' settings, open the transfer panel (see Transfer panel)
  540.      and turn on the `Override transfer path' switch. Now you can
  541.      select the names of the directories to store files received in
  542.      using the path panel (see Path panel).
  543.  
  544.  18. Sometimes `term' stops processing input and output and just beeps
  545.      when a key is hit.
  546.  
  547.      Look at the status line, if it displays `Holding' `term' has
  548.      received an `xOFF' character. Press `Control + S' to restart.
  549.  
  550.  19. When I moved my configuration files into a different drawer and
  551.      updated my main configuration the phonebook entries started to
  552.      `forget' about their settings files.
  553.  
  554.      `term' uses the environment variable `TERMCONFIGPATH' to locate
  555.      its configuration files. However, the local phonebook entries may
  556.      have different search paths set. Check the paths settings to see
  557.      where they are pointing to.
  558.  
  559.  20. Even though several files are selected for transfer only the very
  560.      first file is sent.
  561.  
  562.      Not every file transfer protocol supports batch transfers.  There
  563.      is no way for `term' to tell whether a protocol supports batch
  564.      transfers, please consult your protocol documentation for more
  565.      information.
  566.  
  567.  21. Even though everything is set up correctly no ARexx scripts are
  568.      executed.
  569.  
  570.      In order for ARexx to work the `RexxMast' program needs to be
  571.      running. Usually, this program is located in the `System' drawer
  572.      of your system partition.  Drag it into the `WBStartup' folder in
  573.      order to use it at system startup time. Also make sure ARexx knows
  574.      where to find your ARexx scripts. Either give a complete path name
  575.      or copy your file into the `REXX:' drawer. Do not rely upon an
  576.      `Assign REXX: <drawer name> add' call in your `S:User-Startup'
  577.      file to work, as of this writing ARexx does not support
  578.      multi-volume assignments.
  579.  
  580.  22. Even though the auto-download feature of the current file transfer
  581.      protocol is enabled no auto transfer takes place while an ARexx
  582.      script is running.
  583.  
  584.      Serial I/O processing only takes place if the main program takes
  585.      care of terminal output.
  586.  
  587.  23. Running `term' twice from shell does not cause two `term'
  588.      processes to be started, instead only the first program is
  589.      reactivated.
  590.  
  591.      By default starting `term' more than once only brings an already
  592.      running `term' process to the front. Use the `NEW' keyword to
  593.      suppress this feature.
  594.  
  595.    (To be continued)
  596.  
  597. Reporting bugs
  598. **************
  599.  
  600.    `term' is a rather complex program which is difficult to maintain,
  601. especially since there is only one person to take care of it: me.
  602. Although one tries to write correct, bug-free software, one cannot
  603. always achieve this goal. Tough, but that's life. It rains when you
  604. leave the umbrella at home. Toast falls buttered-side down. The phone
  605. rings while you are in the bath.
  606.  
  607.    In case you come upon one of those nasty features which even the
  608. author was unable to track down and remove, follow these steps:
  609.  
  610.   1. Keep calm.  Shouting, cursing, crushing disks may help to cool
  611.      your temper, but it will not help anybody (the least yourself!) if
  612.      it results in a sudden cardiac infarction: you will have problems
  613.      in reporting the problem.
  614.  
  615.   2. Read the documentation!  The bug you may want to report may be a
  616.      deliberate feature.
  617.  
  618.   3. Repeat previous step as often as possible.  Yes, really, do so.
  619.      Read the documentation. You will be glad you did.
  620.  
  621.   4. Describe your problem elaborately.  A comment like `things fall
  622.      down when dropped' may have inspired Sir Isaac Newton, but a
  623.      similarly laconic comment `downloads do not work' will most
  624.      certainly fail to give any useful hints how to approach the
  625.      problem. In case you encounter a problem with the built-in
  626.      terminal emulation, try to make a verbatim file capture (i.e. turn
  627.      off the `Capture filter') of the session in which the offending
  628.      codes were used and send it to me.
  629.  
  630.   5. If you wish to report a bug in the ARexx interface include a
  631.      sample ARexx script to produce the bug.
  632.  
  633.   6. Do not forget to write it down!  There is a difference between
  634.      noticing a bug and reporting it (honestly!). Do not suppose that a
  635.      bug will be fixed in a future program revision or rely on anybody
  636.      else to report it: do it yourself. Send a letter to the author,
  637.      preferably per electronic mailing services. The addresses are
  638.      given at the end of this document.
  639.  
  640.   7. State your system and program configuration.  It helps a lot to
  641.      know on which machine the program caused problems. Please include
  642.      information such as memory expansion size, Amiga model (A500+,
  643.      A600, A1200, A3000, A4000, etc.), graphics hardware (ECS, AGA,
  644.      etc.), CPU type (MC68000, MC68020, MC68030, MC68040, etc.).
  645.  
  646.  
  647.    If you can please run the standard Commodore debugging tools
  648. (`Enforcer', `Sushi', `tnt', `MungWall', `SegTracker') in the
  649. background and capture the output. If you include `Enforcer' hit
  650. reports make sure that you have `SegTracker' running in the background
  651. or the `Enforcer' output will be worthless to me.
  652.  
  653.    Please direct reports of problems with the file transfer and
  654. terminal emulation libraries to the respective authors, I am not
  655. responsible for maintaining the support libraries.
  656.  
  657.    Error reports concerning the ARexx interface should include a sample
  658. script to illustrate what is going wrong.
  659.  
  660. Background
  661. **********
  662.  
  663.    This program is a product of anger and despair; I was unable to find
  664. a telecommunications program to suit my personal needs, neither in the
  665. commercial area, nor in the public-domain.
  666.  
  667.    Most programs had a lot of extras but lacked other more important,
  668. perhaps more sensible features (just to take an example: in revision
  669. 2.20c and after four years of constant development `Handshake' still
  670. fails to use the current keymap settings and also strips the high order
  671. bit when receiving text - sorry Eric, that's why I never registered!).
  672.  
  673.    I have hesitated for a long time before starting my first attempt at
  674. writing my very own telecommunications program. When Kickstart 2.x was
  675. about to become widely available I took the opportunity to create
  676. `term' always trying to use the new OS routines wherever possible.
  677. While this started to be quite a difficult task it also was a lot of
  678. fun (imagine Columbus wrecking his fleet four times on his journey to
  679. the West Indies due to unexpected leakages in all vessels and sudden
  680. changes in the ships' sailing manuals - that's how I felt!).
  681.  
  682.    As far as computer-telecommunications are concerned, Germany appears
  683. to be a developing country. This is partly due to the Deutsche
  684. Bundespost, the federal mail/phone company whose telecommunications
  685. monopoly used to be protected by federal law.  Until 1989 you would
  686. risk a heavy penalty if using a non-registered modem or telephone
  687. instead of the Bundespost-supplied hardware. So, if you have any
  688. complaints or miss a few extremely important features in `term', don't
  689. boo and hiss, I am not as long in the telecomm business as you are (I
  690. have yet seen only a single `DEC VT101' from afar!). Tell me what you
  691. need and I will try to add it in the next revision.
  692.  
  693.    This project was started at December 24 1990 and completed by
  694. January 25 1991.
  695.  
  696. Future
  697. ******
  698.  
  699.    I spent almost five years of my life programming and updating `term'.
  700. Support for new operating system features was added as soon as Commodore
  701. lifted the veil. `term' grew both in functionality and size, it was
  702. difficult to make plans for the path development would follow. While I
  703. have no specific idea which turn development may take in the future
  704. there are a few things I definitely do not want to add:
  705.  
  706.    * FAX support
  707.  
  708.      There are plenty of good commercial FAX solutions available for
  709.      the Amiga. I lack both the time and the motivation to add FAX
  710.      support to `term'. However, future `term' releases may provide
  711.      interfaces to FAX programs.
  712.  
  713.    * More terminal emulations
  714.  
  715.      `term' offers support for the XEM standard, making it possible to
  716.      easily add external terminal emulation libraries. If you are
  717.      looking for a RIP emulation or a certain Data General terminal
  718.      emulation, try to find an external emulation library.
  719.  
  720.    * Script language
  721.  
  722.      `term' supports ARexx, I don't see any reason why I should add
  723.      another script language.
  724.  
  725.    * More file transfer protocols
  726.  
  727.      Except for the ASCII transfer routines `term' offers no built-in
  728.      file transfer protocols. This is what the XPR interface is for,
  729.      external file transfer libraries provide all the file transfer
  730.      services. If you need a file transfer protocol, look for an
  731.      external transfer protocol library.
  732.  
  733.    * Reduced functionality
  734.  
  735.      It was `tough' enough to implement all the features, bits & pieces
  736.      that make up `term'. Honestly, I don't have the heart to cut back
  737.      features.  It would not have been the first attempt to make `term'
  738.      smaller either; there have been numerous attempts to create
  739.      programs to copy the functionality of `term' or to build a
  740.      smaller, scaled down terminal program based upon the `term' source
  741.      code. As far as I know none of these attempts was successful.
  742.  
  743.    It is difficult to judge how the next `term' release will look like.
  744. Also, v4.6 may be the last `term' release, but then again maybe not.
  745. The future of `term' depends on its users, and this includes you.
  746.  
  747. Acknowledgements
  748. ****************
  749.  
  750.    My thanks go to the following people for their invaluable help and
  751. assistance: Andreas Kirchwitz, Christoph Teuber, Christopher Wichura,
  752. Garry Glendown, Germar Morgenthaler, Henning Hucke, Holger Lubitz,
  753. Juergen Otte, Marc-Christian Schroer, Marko Kuechmann, Markus Stoll,
  754. Martin Berndt, Martin Taillefer, Matthias Zepf, Michael Vaeth,
  755. Michael-Wolfgang Hohmann, Oliver Wagner, Peter Fischer, Ralf Thanner,
  756. Ralph Schmidt, Roby Leemann & AUGS, Stefan Becker, Thorsten Seidel,
  757. Till `Dill-Prince' Prinzler, Udo Wolt, Ueli Kaufmann, Veith
  758. Schoergenhummer, Volker Ulle & the Aquila Sysop Team and to all those
  759. who supplied libraries & control sequence tables.
  760.  
  761.    Special thanks go to John Burton of Papua New Guinea who revised and
  762. rewrote certain parts of the program, in particular the terminal
  763. emulation routines, Leo Schwab who discovered means to use interleaved
  764. screen bitmaps in a system-integrated manner and to Nicola Salmoria
  765. whose invaluable assistance helped to reduce the incredible number of
  766. bugs lurking in the source code.
  767.  
  768.    Additional user interface wizardry and advice by Martin Taillefer.
  769. The file transfer section of this manual was rewritten to incorporate
  770. several suggestions made by Mike Safer.
  771.  
  772.    The `Technical Reference for Hayes Modem Users' was supplied by
  773. Maxwell Daymon, thanks much.
  774.  
  775.    The XPR libraries were created by Terence Finney (`bplus'), Marco
  776. Papa & Stephen Walton (`kermit'), Jack Rouse (`quickb'), Marc Boucher
  777. (`xmodem'), Ueli Kaufmann (`ascii', `ymodem' & `vms') and Rick Huebner
  778. & William M. Perkins (`zmodem').
  779.  
  780.    The XPR standard was created by Willy Langeveld, the quicksort
  781. routine (`QuickSort.asm') was written by David Jones.
  782.  
  783.    The current implementation of the external terminal emulation
  784. library interface was developed by Ueli Kaufmann, who also wrote the
  785. external terminal emulation libraries supplied with `term'.  Without
  786. the invaluable help of Martin Berndt the library interface would
  787. probably not be working at all.
  788.  
  789.    Since time did not permit me to translate the full original German
  790. documentation into English, I had asked the Z-Net Amiga community for
  791. help. As a result this document was translated by three different
  792. authors (in order of translation): me, Marc Schroer and Henning Hucke.
  793. Garry Glendown took care of the original termRexx documentation -
  794. thanks to all of you!
  795.  
  796.    The beta tester group, consisting of Abdelkader Benbachir, Alfredo
  797. Rojas, Andreas M. Kirchwitz, Bernd Ernesti, Bob Maple, Bodo Thevissen,
  798. Chris Hanson, Chris Mattingly, Christoph Guelicher, Christopher G.
  799. Newby, Christian Hechelmann, Dabe Murphy, Daniel M. Makovec, Dean S.
  800. Pemberton, Eric W. Sommer, Florian Hinzmann, Frank Duerring, Gary B.
  801. Standen, Gregory A. Chance, Holger Heinrich, Holger Lubitz, Hung-Tung
  802. Hsu, Jason C. Leach, Jason Soukeras, Jay Grizzard, Joel E. Swan,
  803. Jonathan Tew, Juergen Zeschky, Julian Matthew, Kai Iske, Karsten
  804. Rother, Kay Gehrke, Keith A Stewart, Keith Christopher, Kenneth
  805. Fribert, Klaus Duerr, Leon D. Shaner, Marcel Doering, Mark Constable,
  806. Martin Berndt, Matthias Merkel, Matthias Scheler, Matti Rintala,
  807. Michael Zielesny, Olaf Peters, Ottmar Roehrig, Peer Hasselmeyer, Peter
  808. L. Banville Jr., Piotr Kaminski, Robert L. Shady, Robert Reiswig,
  809. Rodney Hester, Russell John LeBar, Sebastian Delmont, Stefan Becker,
  810. Stefan Gybas, Stefan Hudson, Stellan Klebom, Steve Corder, Sven Reger,
  811. Tony Kirkland, William Michael Mushkin and Yves Perrenoud, took care of
  812. testing the program - thank you very, very much!
  813.  
  814. Source code
  815. ***********
  816.  
  817.    Since there are still only very few well-documented examples (or
  818. general programming examples) for Kickstart 2.x and Kickstart 3.x I
  819. have decided to include the full `C' source code with the `term'
  820. distribution.
  821.  
  822.    The source code is *not* intended for commercial use. If you are
  823. about to include portions in commercial programs you will need to ask
  824. me for permission. Still you may use parts of the source code for
  825. non-commercial software development without my consent.
  826.  
  827.    I sincerely hope that the release of the full `term' source code
  828. will give Kickstart 2.x a better start (I've overcome quite a lot of
  829. obstacles) so that more programs to use the new OS features will be
  830. available soon.
  831.  
  832. Documentation and online help
  833. *****************************
  834.  
  835.    `term' comes bundled with a number of documentation files, these are:
  836.  
  837. `term.doc'
  838.      Human-readable english program documentation in standard ASCII
  839.      format.
  840.  
  841. `term.guide'
  842.      English program documentation in AmigaGuide format suitable to
  843.      submit to `AmigaGuide' or `MultiView'.
  844.  
  845. `termRexx.doc'
  846.      Human-readable english `term' ARexx interface documentation in
  847.      standard ASCII format. This file describes all the ARexx host
  848.      commands `term' supports and also gives a brief introduction how
  849.      to use them.
  850.  
  851. `termRexx.guide'
  852.      English ARexx interface documentation in AmigaGuide format
  853.      suitable to submit to `AmigaGuide' or `MultiView'.
  854.  
  855. `xprascii.doc ... xprzmodem.doc'
  856.      Human-readable documentation on the XPR transfer libraries
  857.      supplied with `term'.
  858.  
  859.    In addition to the pure ASCII files documentation files are
  860. available in TeX-DVI format and Postscript. As space requirements do
  861. not permit to include them on the distribution disks they are only
  862. available directly from the author.
  863.  
  864. `term.dvi'
  865.      English program documentation in a format suitable for printing
  866.      using a utility to print TeX-DVI-output files, such as supplied
  867.      with the packages AmigaTeX or PasTeX.
  868.  
  869. `term.ps'
  870.      English program documentation in Postscript format. This file was
  871.      generated from `term.dvi' using the `dvips' utility.
  872.  
  873. `termRexx.dvi'
  874.      English ARexx interface documentation in a format suitable to
  875.      printing using a utility to print TeX-DVI-output files, such as
  876.      supplied with the packages AmigaTeX or PasTeX.
  877.  
  878. `termRexx.ps'
  879.      English ARexx interface documentation in Postscript format.  This
  880.      file was generated from `termRexx.dvi' using the `dvips' utility.
  881.  
  882.    In order to take advantage of the online-help feature, AmigaGuide
  883. and the file `term.guide' are required. Copy the file to the drawer the
  884. `term' main program is located in and configure the ``term' help text
  885. file' settings (see Path panel) to point to `PROGDIR:term.guide'. Once
  886. this has been done, pressing the `Help' key in any window to support
  887. online help will bring up a help window.
  888.  
  889. Foreign language support
  890. ************************
  891.  
  892.    `term' supports foreign language text catalog tables as introduced
  893. with Workbench 2.1 `locale.library'. As of this writing there are
  894. Danish, Dutch, French, German, Italian, Spanish and Swedish
  895. translations of the program text available. If you wish to create your
  896. own national translation table you should consult the program source
  897. code file `term-blank.ct' which is a blank translation table. Before
  898. actually starting to fill in the translation table you should contact
  899. me first; there may already be someone preparing a translation.
  900. However, you should keep in mind that once you have created a foreign
  901. language translation of the program text I may ask you to update your
  902. translation for a future program release.
  903.  
  904.    Once you are finished with the translation table, send it to me on
  905. disk or via eMail, *don't compile the catalog on your own!*.
  906.  
  907. Workbench and Shell
  908. *******************
  909.  
  910.    The program can be started both from Workbench and from Shell.
  911. Kickstart 2.04 (revision 37.175) and Workbench 2.04 (revision 37.67)
  912. are the minimum required to run `term'.
  913.  
  914.    The `behaviour' of `term' can be changed by adding tool type entries
  915. to the corresponding Workbench icon or by specifying additional command
  916. line parameters when running the program from the Shell. Supported
  917. keywords are:
  918.  
  919. `WINDOW'
  920.      The console window specifier to be used when opening terminal
  921.      output windows (this will override the default settings). The
  922.      default is `CON:0/11//100/term Output Window/CLOSE/SCREEN %s'. The
  923.      `%s' will be replaced by the name of the public screen `term' uses.
  924.  
  925. `PUBSCREEN'
  926.      The name of a public screen to open the `term' window on. In case
  927.      the public screen happens to be unavailable, `term' will fall back
  928.      to the Workbench screen. Note that `term' assumes that the main
  929.      window is to be opened on a public screen rather than on a custom
  930.      screen if this option is in effect, regardless how the default
  931.      settings may be configured.
  932.  
  933. `STARTUP'
  934.      The name of an ARexx script file to be run on program startup.
  935.  
  936. `PORTNAME'
  937.      The ARexx host port name `term' is to use instead of the built-in
  938.      default name. The port name will be translated to upper case
  939.      characters as required by the ARexx host port naming convention.
  940.      The resulting name must be unique or `term' will fall back to its
  941.      built-in default name.
  942.  
  943. `SETTINGS'
  944.      This keyword determines where to read the default configuration
  945.      file from. In order to read it from `Work:term/config', one would
  946.      use `term Settings Work:term/config' from Shell or add the tooltype
  947.      entry `SETTINGS=Work:term/config' from Workbench. This argument
  948.      does not necessarily need give the name of a path to search, but
  949.      can also specify the name of the configuration file to be used.
  950.  
  951. `UNIT'
  952.      Similar to the `DEVICE' keyword the `UNIT' keywords affects the
  953.      serial driver settings. It determines which serial driver unit is
  954.      to be used instead of the one specified in the default
  955.      configuration file. In order to use unit number 4 one would use
  956.      `term Unit 4' from Shell or add the tooltype entry `UNIT=4' from
  957.      Workbench.
  958.  
  959. `DEVICE'
  960.      In order to use a different serial device driver than the one
  961.      specified in the default configuration file, use this keyword. To
  962.      use `duart.device' one would use `term Device duart.device' from
  963.      Shell or add the tooltype entry `DEVICE=duart.device' from
  964.      Workbench.
  965.  
  966. `QUIET'
  967.      If this parameter is present, the program will not start opening a
  968.      display but rather put an icon on the Workbench backdrop, waiting
  969.      to be invoked. A double-click will bring it to life. This
  970.      parameter will be ignored in case the `STARTUP'-Parameter is used
  971.      along with it.
  972.  
  973. `SYNC (Shell only)'
  974.      If called from Shell `term' will detach itself immediately
  975.      allowing the Shell window to be closed afterwards. This effect can
  976.      be avoided if `SYNC' is entered in the command line.
  977.  
  978. `NEW (Shell only)'
  979.      Usually, running `term' twice will cause the screen of the other
  980.      program to be popped to the front instead of creating a second
  981.      `term' process. To avoid this effect, enter `NEW' as a calling
  982.      parameter. If called from Workbench, each program will run as a
  983.      separate process.
  984.  
  985. `BEHIND'
  986.      This option will cause `term' to open its screen behind all other
  987.      screens and not to activate its window.
  988.  
  989. `PHONEBOOK'
  990.      Similiar to the `SETTINGS' option you can specify the name of a
  991.      phonebook file to load upon startup.
  992.  
  993. `AUTODIAL'
  994. `AUTOEXIT'
  995.      These two options are used in conjunction with the Auto-Dial and
  996.      Auto-Exit features. Even if the phonebook does not have these
  997.      options enabled, you can nevertheless tell `term' to enable them
  998.      as soon as the phonebook file is loaded. It will then go through
  999.      the routine setups for auto-dialing. Fore more information on these
  1000.      features see Phonebook.
  1001.  
  1002. User interface notes
  1003. ********************
  1004.  
  1005.    To operate a gadget, press the key corresponding to the letter
  1006. highlighted in the gadget label. Suppose a slider is labeled `Baud
  1007. rate' with the letter `r' of the word `rate' underlined; in order to
  1008. increase the slider value one had to hit the key labeled `R', to
  1009. decrease the value one is to hold down either `Shift' key while
  1010. pressing the key `R'.
  1011.  
  1012.    With some requesters and windows text gadgets will be
  1013. auto-activated. Pressing the `Return' key will cycle through all the
  1014. available text gadgets, holding down either `Shift' key will break the
  1015. cycle.
  1016.  
  1017.    Windows in which only a single scrolling list is present cursor keys
  1018. may be used to scroll the contents.
  1019.  
  1020.    The `Return' and `Escape' keys are respected by most windows. A
  1021. button surrounded by a recessed box represents the default choice in a
  1022. requester, pressing the `Return' key will select it. The `Escape' key
  1023. always selects the `stop' or `cancel' button usually to be found in the
  1024. lower right corner of a window. Most windows to feature a close gadget
  1025. in the upper left corner can be closed by pressing the `Escape' key.
  1026.  
  1027.    In control panels featuring a `Tab' button, pressing the `Tab' key
  1028. will flip the pages.
  1029.  
  1030.    Numeric entry fields accept input several notations, namely
  1031. hexadecimal (`$..' and `0x..'), octal (`&..') and binary (`%..').
  1032.  
  1033.    The user interface support library tries to make all control panel
  1034. windows fit on the screen. If the first attempt fails a different font
  1035. is used. If this did not help either a new screen will be opened for
  1036. the window. This screen will usually be larger than the visible region.
  1037. Move the mouse towards the borders of the screen to reveal more of it.
  1038.  
  1039. Screen
  1040. ******
  1041.  
  1042.    At the bottom of the `term' screen or window a small display shows a
  1043. few basic parameters. These are:
  1044.  
  1045. `Status'
  1046.      The current program operating status. This includes `Ready',
  1047.      `Holding' (`Control + S' was pressed), `Dialing' (the dialing
  1048.      function is at work), `Upload' (data is being sent), `Download'
  1049.      (data is being received), `Breaking' (a break signal is
  1050.      transmitted across the serial line), `Hanging up' (connection is
  1051.      being cancelled), `Recording' (a script is being recorded) and
  1052.      `Rec.line' (a line of text is being recorded).
  1053.  
  1054. `Buffer'
  1055.      Indicates whether the text buffer is currently recording incoming
  1056.      text or whether the current text buffer contents are frozen.
  1057.  
  1058. `Protocol'
  1059.      The currently selected data transfer protocol.
  1060.  
  1061. `Emulation'
  1062.      The currently active terminal emulation mode.
  1063.  
  1064. `Rate'
  1065.      The data transfer rate in bits per second (= Baud).
  1066.  
  1067. `Params.'
  1068.      The current serial parameters (Data bits-Parity-Stop bits).
  1069.  
  1070. `Time'
  1071.      The current time of day.
  1072.  
  1073. `Online'
  1074.      The time elapsed after a connection was successfully established.
  1075.      This counter will be stopped as soon as the connection is
  1076.      cancelled (e.g. by hanging up) and is reset to 00:00:00 as soon as
  1077.      a new connection is made.
  1078.  
  1079.      This display will show the online time, the online cost or both
  1080.      (toggled every five seconds) depending on your current settings.
  1081.  
  1082.    Unless configured different, the screen itself is opened as a public
  1083. screen (called `TERM') which is available to other programs for their
  1084. purposes. If more than one `term' process is running, the public screen
  1085. name will change according to the number of the program (i.e. the first
  1086. `term' to be started will call the scren `TERM', the second one will
  1087. call it `TERM.1', the third one `TERM.2', etc.). The screen title bar
  1088. will also display the name of the public screen.
  1089.  
  1090. Menus
  1091. *****
  1092.  
  1093.    For each requester and input window there exists a set of menu items
  1094. to execute the commands associated with the buttons, dials and gauges in
  1095. the requester/window. Press the right mouse button to have a look at
  1096. the commands and their shortcuts.
  1097.  
  1098.    The following text is to describe the menu items available in the
  1099. `term' main menu.
  1100.  
  1101. Project
  1102. =======
  1103.  
  1104. `Save screen as Picture/Text'
  1105.      This menu serves to save the current terminal window contents
  1106.      either as plain ASCII text file or as a picture file.
  1107.  
  1108. `Print Screen (as text)/Clipboard'
  1109.      These menu entries are to output plain text on the printer. You
  1110.      can either print the contents of the main screen or the contents
  1111.      of the clipboard.
  1112.  
  1113. `Print Screen (as graphics)'
  1114.      Select this menu entry to make a hardcopy of the screen contents.
  1115.      Printing will respect screen colours and follow the on-screen bit
  1116.      image.
  1117.  
  1118. `Capture to File/Raw file/Printer'
  1119.      Selecting one of these menu entries will toggle capturing incoming
  1120.      text to the printer and/or a file on disk. The `Raw file' option
  1121.      will capture incoming text without applying any filtering or
  1122.      modifications.  You can get the same effect by turning off the
  1123.      `Capture filter' in the capture settings (see Capture panel) and
  1124.      selecting the `Capture to file' option, but probably not as
  1125.      quickly.
  1126.  
  1127. `Iconify'
  1128.      Closes all screens and windows `term' has currently open, if this
  1129.      feature is enabled, resets and releases the serial driver and puts
  1130.      an icon into the Workbench window.  Double-clicking this icon will
  1131.      cause `term' to wake up and to return the state is was in before
  1132.      iconification took place.
  1133.  
  1134.      *While `term' is iconified, most incoming ARexx-commands will be
  1135.      queued and the corresponding ARexx scripts will appear to `hang'.
  1136.      In order to reactivate the program either double-click on the
  1137.      program icon or send the ARexx command `ACTIVATE'. As soon as
  1138.      `term' is `awake' again pending commands will be processed again*
  1139.  
  1140. `About'
  1141.      Shows some information on the program.
  1142.  
  1143. `Quit'
  1144.      Terminates the program, hold down a `Shift' key to quit
  1145.      immediately, otherwise you will be prompted to confirm your
  1146.      decision.
  1147.  
  1148. Edit
  1149. ====
  1150.  
  1151. `Copy'
  1152.      In order to transfer any currently marked screen text to the
  1153.      clipboard buffer, select this menu item. Text can be marked by
  1154.      double-clicking the select button while the mouse is over a word
  1155.      or by clicking the select button and dragging the mouse. Holding
  1156.      down either shift key will append the selected text to the current
  1157.      clipboard contents.  In any other case the new text will replace
  1158.      the previous contents.
  1159.  
  1160. `Paste'
  1161.      Pastes the contents of the clipboard at the current cursor position
  1162.      provided that the clipboard contains text data. Hold down either
  1163.      `Shift' key to have `term' include the `Paste prefix' and the
  1164.      `Paste suffix' (see Clipboard panel) along with the clipboard
  1165.      contents.
  1166.  
  1167. `Clear'
  1168.      Any currently marked text will be released as soon as any rendering
  1169.      operations are to be executed in the main window. To release marked
  1170.      text manually, select this menu item.
  1171.  
  1172. Cmds. (= Commands)
  1173. ==================
  1174.  
  1175. `Execute AmigaDOS command'
  1176.      Enter the command you want to execute and its command line
  1177.      arguments here.
  1178.  
  1179. `Execute ARexx command'
  1180.      This function calls the ARexx server to execute a script file. If
  1181.      the first input character is a ` or " the input will be considered
  1182.      as a small program in a single line. Note that this function will
  1183.      not be available if the ARexx server isn't running.
  1184.  
  1185.      The ARexx command set supported by `term' is described in the
  1186.      `term' ARexx interface documentation.
  1187.  
  1188. `Record script'
  1189.      Select this menu item to start/stop script recording. More on
  1190.      script recording can be found under script recording (see Script
  1191.      recording).
  1192.  
  1193. `Record line'
  1194.      When in script recording mode this menu item will cause `term' to
  1195.      temporarily switch into full line recording mode, rather than
  1196.      recording only single keystrokes. Pressing the `shift+return' keys
  1197.      has the same effect as calling the `Record line' menu item. More
  1198.      on the topic of script recording can be found under script
  1199.      recording (see Script recording).
  1200.  
  1201. `Edit traps...'
  1202.      This brings up the trap list editor (see Trap panel.  The list
  1203.      includes control sequences `term' is to look for in the incoming
  1204.      data stream. When a sequence is found the corresponding command
  1205.      sequence (see Command sequences) is executed.
  1206.  
  1207.      The window contains the usual list management tools (edit, add,
  1208.      remove, clear and move). Please note that the order of processing
  1209.      occurs top-down, i.e. of two entries with the same control
  1210.      sequence data only the top-most will be evaluated.
  1211.  
  1212.      The buttons `Load' and `Save' will let you restore and save the
  1213.      current trap list. The `Load' button appends the contents of a
  1214.      trap list file to the current trap list, so take care. On startup
  1215.      `term' looks for a configuration file named `trap.prefs' and tries
  1216.      to load it. Thus, there can be only one global trap list. It is up
  1217.      to ARexx to load and modify the contents of the trap list,
  1218.      although this editor window provides a graphical interface to the
  1219.      list. Please note that the more list entries `term' has to filter
  1220.      through the input data stream the slower input processing may
  1221.      become, affecting mostly terminal output.
  1222.  
  1223. `Disable traps'
  1224.      This menu item provides a shortcut to stop trap list processing.
  1225.      On startup `term' will enable trap list processing if the trap
  1226.      list loaded from disk is non-empty.
  1227.  
  1228. Phone
  1229. =====
  1230.  
  1231. `Phonebook'
  1232.      The phonebook is one of the most powerful and complex functions of
  1233.      `term' and will be described later in this document (see
  1234.      Phonebook).
  1235.  
  1236. `Redial'
  1237.      Dialing list entries which the dialing routine was unable to
  1238.      establish a connection to are once again passed to the dialer.
  1239.  
  1240. `Dial phone number'
  1241.      To dial a single phone number select this menu item. The phone
  1242.      number entered will be passed to the dialing routine.
  1243.  
  1244. `Send break'
  1245.      Sends a `break' signal across the serial line.
  1246.  
  1247. `Hang up'
  1248.      Tells the modem to hang up the serial line.
  1249.  
  1250. `Wait'
  1251.      Will cause `term' to emit the character sequence `<Blank
  1252.      space><Backspace>' every second in order to fool the remote into
  1253.      believing that terminal input is currently taking place.
  1254.  
  1255. `Flush receive buffer'
  1256.      Tells the serial driver to drop its input buffer contents and
  1257.      resets the state of the internal serial buffers.
  1258.  
  1259. `Release serial device'
  1260.      The serial driver is released for other programs to use it. A
  1261.      requester will appear which allows you to reopen the serial driver
  1262.      or to quit `term'.
  1263.  
  1264.      If the serial driver has been released by the ARexx interface and
  1265.      has not been reopened yet, this menu item will do it.
  1266.  
  1267.    If you are still online, the `Redial' and `Dial' menu entries will be
  1268. disabled. In order to make another call, hang up the line first.
  1269.  
  1270. Transf. (= Transfer)
  1271. ====================
  1272.  
  1273.    This menu provides access to file transfer functions. For more
  1274. information on this topic, see Transfer panel, XPR options sample,
  1275. Transfer progress panel, ASCII-transfer panel and ASCII-transfer
  1276. settings.
  1277.  
  1278. `Upload ASCII file(s)'
  1279.      This is a pure ASCII-file upload. It was added to allow poor BBS
  1280.      programs to receive text files.
  1281.  
  1282. `Download ASCII file(s)'
  1283.      This is a pure ASCII-file download. Refer to `Upload ASCII
  1284.      file(s)' for features/options of this mode.
  1285.  
  1286. `Upload text file(s)'
  1287.      Sends a file/files to the remote receiver using the current
  1288.      transfer protocol. If possible this command will `ask' the
  1289.      transfer protocol to transmit the file(s) in text mode (whatever
  1290.      that means) which may include CR/LF substitution and other
  1291.      gimmicks. Consult the library documentation to find out if your
  1292.      favourite transfer library supports text mode.
  1293.  
  1294. `Download text file(s)'
  1295.      Request a file/files using the current transfer protocol. Refer to
  1296.      `Upload text file(s)' for features/options of this mode.
  1297.  
  1298. `Edit & upload text file'
  1299.      Invokes the currently selected (see Path panel) text editor on a
  1300.      file to be selected using a file requester. `term' pays attention
  1301.      to the `EDITOR' environment variable and will use the program
  1302.      indicated by it.
  1303.  
  1304.      `term' will block and wait until the editor has returned.
  1305.  
  1306.      After the editor has returned, the user will be asked whether the
  1307.      file edited is to be transferred as plain ASCII or via text upload.
  1308.  
  1309. `Upload binary file(s)'
  1310.      Send a file/files to the remote receiver using the current transfer
  1311.      protocol. True batch upload is supported both through wildcard
  1312.      expressions (`#?.txt' will send all files whose names end with
  1313.      `.txt') or through multiple selection. Refer to the documentation
  1314.      of your favourite transfer library to find out if batch file
  1315.      transfer is supported.
  1316.  
  1317. `Download binary file(s)'
  1318.      Receive a file/files using the current transfer protocol. If the
  1319.      protocol does not support batch download you are required to enter
  1320.      the name of the file to be received. Files which remain empty
  1321.      after the transfer are deleted automatically.
  1322.  
  1323.    The transfer routines open an information window in which a number of
  1324. transfer parameters are displayed (see Transfer progress panel).
  1325.  
  1326. Buffer
  1327. ======
  1328.  
  1329. `Clear buffer'
  1330.      Clears the contents of the text buffer (see Text buffer). Any text
  1331.      will be discarded and *cannot* be recovered. Capture files are not
  1332.      affected by this command.
  1333.  
  1334. `Display buffer'
  1335.      Opens the text buffer screen (see Text buffer).
  1336.  
  1337. `Close buffer'
  1338.      Closes the text buffer screen but does not free the contents.
  1339.  
  1340. `Freeze buffer'
  1341.      This menu entry will, if enabled, stop the text buffer from
  1342.      filling up with new text.
  1343.  
  1344. `Load buffer'
  1345.      Loads the contents of the text buffer from a file. If there are
  1346.      still text lines in the text buffer a requester will appear giving
  1347.      you the choice to discard the old data, append the new data, or to
  1348.      cancel the action.
  1349.  
  1350. `Save buffer as'
  1351.      Saves the contents of the text buffer to a file. You will be
  1352.      notified if the file to save to already exists (you may discard
  1353.      the old file, append the new data or cancel the action).
  1354.  
  1355. Terminal
  1356. ========
  1357.  
  1358. `Clear screen'
  1359.      Clears the whole `term' screen and moves the cursor to the top
  1360.      left home position.
  1361.  
  1362. `Reset font'
  1363.      Will change the screen font back to the default screen font.
  1364.  
  1365. `Reset styles'
  1366.      Resets all character style attributes (bold, blinking, inverse
  1367.      video, underlined, etc.) and sets the text colour to the default
  1368.      pen.
  1369.  
  1370. `Reset terminal'
  1371.      Use this menu item to reset the state of the entire terminal
  1372.      emulation.
  1373.  
  1374. Settings
  1375. ========
  1376.  
  1377.    This is where you configure the standard preferences settings. If
  1378. you select `New' in the phonebook window (see Phonebook) these standard
  1379. settings will be used.  Put in your most commonly used settings here.
  1380. Change individual entries in the phonebook as needed.
  1381.  
  1382. `Serial'
  1383.      See Serial panel
  1384.  
  1385. `Modem'
  1386.      See Modem panel.
  1387.  
  1388. `Screen'
  1389.      See Screen panel.
  1390.  
  1391. `Terminal'
  1392.      See Terminal panel.
  1393.  
  1394. `Emulation'
  1395.      See Emulation panel.
  1396.  
  1397. `Clipboard'
  1398.      See Clipboard panel.
  1399.  
  1400. `Capture'
  1401.      See Capture panel.
  1402.  
  1403. `Commands'
  1404.      See Command panel.
  1405.  
  1406. `Miscellaneous'
  1407.      See Miscellaneous panel.
  1408.  
  1409. `Paths'
  1410.      See Path panel.
  1411.  
  1412. `Transfer protocols'
  1413.      See Transfer panel.
  1414.  
  1415. `Default transfer protocol'
  1416.      If this item is selected, a transfer settings editor is displayed.
  1417.      The `Default transfer library' in the transfer panel (see Transfer
  1418.      panel) determines the contents of this control panel.  If the
  1419.      selected default transfer library does not provide these
  1420.      facilities, a simple text requester will prompt for input. Consult
  1421.      the documentation of the chosen transfer protocol for legal
  1422.      options and the values to which they can be set.
  1423.  
  1424.      As an example, see XPR options sample.
  1425.  
  1426. `Translation tables'
  1427.      See Translation panel.
  1428.  
  1429. `Function keys'
  1430.      See Function key panel.
  1431.  
  1432. `Fast! macros'
  1433.      See Fast macro panel.
  1434.  
  1435. `Hotkeys'
  1436.      See Hotkey panel.
  1437.  
  1438. `Speech'
  1439.      See Speech panel.
  1440.  
  1441. `Sound'
  1442.      See Sound panel.
  1443.  
  1444. `Area codes'
  1445.      See Area code panel.
  1446.  
  1447. `Console window...'
  1448.      Whenever an AmigaDOS/ARexx command is executed an output window is
  1449.      opened. This menu item will bring up a requester allowing you to
  1450.      edit the size and position of the window to be opened (consult
  1451.      your AmigaDOS manual for a description of the window position
  1452.      string). If you do not want the window to appear, simply enter
  1453.      `NIL:'. If the `%s' formatting parameter is used in the output
  1454.      specification it will be replaced by the name of the public screen
  1455.      `term' uses.
  1456.  
  1457. Windows
  1458. =======
  1459.  
  1460. `Status'
  1461.      This function opens a window to display program status information.
  1462.      A click on the `Update' button will cause the information to be
  1463.      brought up to date:
  1464.  
  1465.     `Session start'
  1466.           When was the program started?
  1467.  
  1468.     `Bytes received'
  1469.           The number of bytes received.
  1470.  
  1471.     `Bytes sent'
  1472.           The number of bytes sent.
  1473.  
  1474.     `Connection message'
  1475.           The text returned by the modem when a connection was made
  1476.           immediately following the `CONNECT' message.
  1477.  
  1478.     `Name'
  1479.           If available, the name of the system the modem is currently
  1480.           connected to.
  1481.  
  1482.     `Phone number'
  1483.           If available, the phone number of the system the modem is
  1484.           currently connected to.
  1485.  
  1486.     `Comment'
  1487.           If available, the phonebook comment corresponding to the
  1488.           system the modem is currently connected to.
  1489.  
  1490.     `User name'
  1491.           If available, the user name, as available through the
  1492.           phonebook, corresponding to the system the modem is currently
  1493.           connected to.
  1494.  
  1495.     `Screen size'
  1496.           The size of the terminal output window in characters (columns
  1497.           and rows).
  1498.  
  1499.     `ARexx port name'
  1500.           The name of the ARexx host `term' is currently using.
  1501.  
  1502.     `Buffer size (bytes)'
  1503.           The size of the text buffer (see Text buffer).
  1504.  
  1505.     `Free memory (bytes)'
  1506.           The amount of free system memory.
  1507.  
  1508. `Review'
  1509.      A review window is opened which basically displays the same text
  1510.      as the text buffer screen. You can scroll through the text
  1511.      displayed both by mouse (see the right hand side scroller) and by
  1512.      cursor keys.
  1513.  
  1514. `Packet'
  1515.      Opens an input window in which a single line of characters to be
  1516.      transferred across the serial line can be entered. More on this
  1517.      feature is explained below (see Packet window).
  1518.  
  1519. `Chat line'
  1520.      This adds a one-line text entry field just above the status line
  1521.      (or the bottom of the main window, whatever is available at the
  1522.      moment).  For more information, see Chat line.
  1523.  
  1524. `Fast! macros'
  1525.      Opens or closes the so-called fast macro panel (see Fast macro
  1526.      panel).  For more information on fast! macros see Fast! macros.
  1527.  
  1528. `Single character entry'
  1529.      This may come in handy for serial debugging and those rare cases
  1530.      when there is no keyboard connected to the Amiga. On a 16 by 16
  1531.      raster layout you will find every single character of the
  1532.      ISO-8859-1 set the Amiga uses. Click on any one to have it
  1533.      transmitted across the serial line.  Hold down the left mouse
  1534.      button and drag the mouse across the matrix to see the character
  1535.      code displayed in the window title bar in various notations. Note
  1536.      that with small fonts the binary notation may be cut off.
  1537.  
  1538. `Upload queue'
  1539.      This will open a window featuring a list of files to upload. You
  1540.      can drag icons of files to upload on this window, their names will
  1541.      appear in the list. Dragging icons on the icon labeled `term
  1542.      Upload queue' has the same effect. Double-clicking this icon will
  1543.      open the upload list window on the Workbench screen.  In order to
  1544.      start an upload either press the `Binary upload' or `Text upload'
  1545.      button.
  1546.  
  1547.      You can replace the icon `term' uses by copying the icon of your
  1548.      choice into the drawer `term' resides in and naming it
  1549.      `term_DropIcon'.
  1550.  
  1551.      For more information on the Upload queue see File upload panel.
  1552.  
  1553. The quick dialing menu
  1554. ======================
  1555.  
  1556.    Note: this menu is available only in case any phonebook entries have
  1557. the special `Quick menu' switch set.
  1558.  
  1559.    Selecting any item of this menu will cause the corresponding phone
  1560. number to be dialled. Extended selection and drag-selection are also
  1561. available when picking services to dial. Please note that you can
  1562. `check in' single items by selecting them, but you cannot remove any
  1563. items from the dial list.
  1564.  
  1565.    Phonebook entries in groups appear in submenus, unless there is only
  1566. one group all entries for the quick dialing menu reside in. In this
  1567. case, there will be no single submenu, all entries will appear in one
  1568. regular menu.
  1569.  
  1570. Control panels
  1571. **************
  1572.  
  1573.    This where all the control panels employed by `term' are explained:
  1574.  
  1575. Serial panel
  1576. ============
  1577.  
  1578.    This is where the serial parameters may be changed.
  1579.  
  1580. `Baud rate'
  1581.      The transfer speed in bits per second at which `term' communicates
  1582.      with the serial hardware. The minimum value allowed is 110 baud.
  1583.      You may enter any value you like but keep in mind that not all
  1584.      modems will respond to all possible settings.  Clicking on the
  1585.      arrows pointing to the left and to the right will cycle through a
  1586.      set of predefined rates.
  1587.  
  1588.      As of this writing the standard Amiga serial hardware is capable
  1589.      of running baud rates from 110 up to and including 1,000,000 bits
  1590.      per second. These are the basic hardware limits, but in practice
  1591.      reliable transfer speeds are far lower at 57,600 baud and below.
  1592.      Custom serial hardware may support higher transfer rates. Do not
  1593.      underestimate the overhead caused by the terminal program &
  1594.      interrupt processing and the effects of connecting cable lengths.
  1595.  
  1596.      Most modems will not recognize a sudden change in the baud rate.
  1597.      Type `AT<RETURN>' to make the change known.
  1598.  
  1599.      With data transfer speed greater than 2,400 baud most modems
  1600.      require flow control to be used in order to guarantee reliable
  1601.      data transfer.  In such cases it is recommended to set the
  1602.      `Protocol' switch to `RTS/CTS'. If you fail to do so you may lose
  1603.      data.
  1604.  
  1605. `Bits/char'
  1606.      Number of bits per transferred character (7 or 8). As of this
  1607.      writing the Amiga serial hardware does not support all possible
  1608.      bits/char, parity and stop bits combinations.
  1609.  
  1610. `Parity'
  1611.      Serial parity (none, odd, even, mark or space). As of this writing
  1612.      the Amiga serial hardware does not support all possible bits/char,
  1613.      parity and stop bits combinations.
  1614.  
  1615. `Stop bits'
  1616.      Number of stop bits (1 or 2). As of this writing the Amiga serial
  1617.      hardware does not support all possible bits/char, parity and stop
  1618.      bits combinations.
  1619.  
  1620. `Handshaking'
  1621.      Serial handshaking mode (RTS/CTS 7 wire hardware handshaking,
  1622.      RTS/CTS with DSR signal check, none).  The `RTS/CTS (DSR)' mode
  1623.      will make `term' check the `data set ready' signal first before
  1624.      turning on RTS/CTS handshaking. If no signal is present `term'
  1625.      will turn off RTS/CTS 7 wire hardware handshaking.
  1626.  
  1627.      Some modems will appear to `lock up' when the RTS/CTS handshaking
  1628.      protocol is enabled. This may either be due to a faulty connecting
  1629.      cable (not all cables properly connect the pins required for 7
  1630.      wire hardware handshaking) or due to configuration problems. Some
  1631.      modems factory settings are incompatible with the way the Amiga
  1632.      handles hardware handshaking. In such a case it is very likely that
  1633.      the modem does not set the so-called DSR signal by default. To
  1634.      change this, first turn off RTS/CTS handshaking, then type the
  1635.      command `AT&S0' and press return, now turn RTS/CTS handshaking on
  1636.      again.
  1637.  
  1638.      *The RTS/CTS handshaking protocol must be used for reliable modem
  1639.      connections using transmission speeds of 4,800 baud and above.*
  1640.  
  1641. `Duplex'
  1642.      Determines whether characters are echoed back to the terminal
  1643.      screen or not (full, half = local echo).
  1644.  
  1645. `Buffer size'
  1646.      The number to be specified here allows to set the serial driver I/O
  1647.      buffer size. *Every number you enter here will result in `term'
  1648.      and the serial driver allocating twice the buffer size (this is
  1649.      only a word of warning for those among us who prefer buffer sizes
  1650.      of 256K and up).*
  1651.  
  1652. `Break length'
  1653.      Length of the break signal given in microseconds.
  1654.  
  1655. `High-speed mode'
  1656.      Activates a special mode of the serial driver which is to skip a
  1657.      couple of internal parity and stop bits checks resulting in higher
  1658.      data throughput rate. *If this switch is turned on, the serial
  1659.      parameters will be reset to 8 bits per character, no parity and 1
  1660.      stop bit.* Do not expect dramatic speed increases.
  1661.  
  1662. `Strip bit 8'
  1663.      If this switch is effect each character received or transmitted by
  1664.      `term' will have its high-order bit cleared.
  1665.  
  1666. `Shared access'
  1667.      This switch allows you to run the serial driver in shared access
  1668.      mode.  Not all driver types will allow this to happen.
  1669.  
  1670. `Handle xON/xOFF internally'
  1671.      This switch enables the internal processing of the flow-control
  1672.      characters `xON' (= `Control + S') and `xOFF' (= `Control + Q').
  1673.      Whenever you press `Control + S' `term' will change its state to
  1674.      `holding' and stop terminal input and output processing.  Press
  1675.      `Control + Q' in order to restart.
  1676.  
  1677. `Pass xON/xOFF through'
  1678.      If this switch is enabled, `term' will pass the `xON'/`xOFF'
  1679.      characters through to the modem rather than quietly discarding
  1680.      them.
  1681.  
  1682. `Check carrier'
  1683.      `term' will recognize the `NO CARRIER' message a modem emits when
  1684.      the carrier line signal drops back to low. For maximum safety,
  1685.      `term' will also check the carrier signal line after receiving the
  1686.      `NO CARRIER' message if this switch is enabled. This is to make
  1687.      sure that no accidentally appearing text causes confusion.
  1688.  
  1689.      If this switch is enabled, `term' will check the carrier signal
  1690.      during file transfers and will stop the transfer if the signal is
  1691.      lost. It will also check the carrier signal at program startup and
  1692.      if the signal is detected will start the online timer. If offline,
  1693.      `term' will check the carrier signal periodically and go into
  1694.      online state if the signal is detected.
  1695.  
  1696.      *Note:  Be sure to switch the carrier detect check off in case you
  1697.      wish to transfer files using a null-modem cable!*
  1698.  
  1699. `Direct connection'
  1700.      You can directly connect the Amiga to other computers, such as by
  1701.      using a nullmodem cable. In such a case it does not make good
  1702.      sense to enforce a carrier signal check or to warn you if the
  1703.      transmission speed requires that you enable RTS/CTS handshaking.
  1704.      This switch disables both features.
  1705.  
  1706. `Quantum'
  1707.      The number of bytes `term' tries to read in one chunk at a time.
  1708.      The more bytes read, the more time it takes to process them. While
  1709.      the text is processed, mouse and keyboard input are delayed.
  1710.      Choose this value with care.
  1711.  
  1712. `Use OwnDevUnit'
  1713.      This switch controls whether Christopher Wichura's
  1714.      `OwnDevUnit.library' will be used to schedule access of multiple
  1715.      programs to the currently selected serial device driver.
  1716.  
  1717. `Do not use if device is in shared mode'
  1718.      It may not be a good idea to lock the device driver for exclusive
  1719.      access through OwnDevUnit.library while `term' is trying to share
  1720.      the driver with other applications in non-exclusive mode. For such
  1721.      cases, enable this switch.
  1722.  
  1723. `Release device when online'
  1724.      This option is potentially dangerous. By default `term' will yield
  1725.      control over the serial device driver only if offline, i.e. if no
  1726.      carrier signal is detected, etc. With this switch enabled `term'
  1727.      will let go of the device driver even if a connection is active
  1728.      and you are online. This may cause the device driver to drop the
  1729.      line, you have been warned.
  1730.  
  1731. `Release device when dialing'
  1732.      If your uucp netcall catches you off guard while `term' is still
  1733.      dialing, here is your chance to give the netcall precedence.
  1734.      Please note that although `term' will exit the dialing procedure
  1735.      as quickly as possible and yield control over the serial device
  1736.      driver, it will not automatically start to redial when the device
  1737.      driver becomes available again.
  1738.  
  1739. `Satisfy requests'
  1740.      When a program requests access to the serial device driver, `term'
  1741.      is supposed to let go of the driver if possible. This switch
  1742.      controls what `term' will do in this case:
  1743.  
  1744.     `Release device'
  1745.           The driver is released, just as if you would select the main
  1746.           menu item of the same name.
  1747.  
  1748.     `Release device, attempt to reown'
  1749.           The device driver is released, but `term' will retry every
  1750.           four seconds to reopen and thus `reown' it again.
  1751.  
  1752.     `Keep device open'
  1753.           `term' always ignores requests to release the device driver.
  1754.  
  1755. `Serial device'
  1756.      The name of the serial driver to be used by `term'. This is usually
  1757.      `serial.device' (`modem0.device' for the internal Supra modem,
  1758.      `sxbios.device' for ASDG's serial IO card, `vectorser.device' for
  1759.      the VectorConnection card, `duart.device' for the MultiFaceCard,
  1760.      etc.; consult your hardware manual for more information).
  1761.  
  1762. `Device unit number'
  1763.      The device unit number of the serial driver selected above. This is
  1764.      usually left `0' but can also be used to address multiple serial IO
  1765.      ports.
  1766.  
  1767. `Use'
  1768.      Accept the current settings.
  1769.  
  1770. `Default (phonebook only)'
  1771.      Drop the current settings, making a connection to the corresponding
  1772.      phone number will leave the corresponding main configuration entry
  1773.      unchanged.
  1774.  
  1775. `Cancel'
  1776.      Don't use the current settings.
  1777.  
  1778. Modem panel
  1779. ===========
  1780.  
  1781.    This is where modem control text and other related parameters are
  1782. configured.
  1783.  
  1784. `Modem initialization command'
  1785.      The text to send to the modem after successful program
  1786.      initialization.  This text is optional and thus does not need to
  1787.      be present.
  1788.  
  1789.      The default modem initialization command `term' uses is
  1790.      `ATE1V1Q0\r' which will do the following with a modem that
  1791.      complies to the Hayes Standard AT Command Set Specification:
  1792.  
  1793.        1. [E1] Command state character echo is enabled, so the modem
  1794.           echoes back every character you send to it until it makes a
  1795.           connection.
  1796.  
  1797.        2. [V1] Result codes are displayed as words, so the modem will
  1798.           respond with messages such as `CONNECT', `NO CARRIER', etc.
  1799.           rather than numeric codes.
  1800.  
  1801.        3. [Q0] Result codes are enabled, so that the modem will send a
  1802.           response to any command it receives.
  1803.  
  1804.      For more information on these commands, consult your modem manual.
  1805.  
  1806.      The dialing routine will use the initialization text entered here
  1807.      before dialing a phone number. You can separate multiple
  1808.      initialization commands with vertical bar (`|') characters.  Only
  1809.      the dialer will use them.
  1810.  
  1811. `Modem exit command'
  1812.      The text to be sent to the modem shortly before the program
  1813.      terminates. Just like the modem init text it is optional and does
  1814.      not need to be present.
  1815.  
  1816.      There is no default exit command `term' uses.
  1817.  
  1818.      The dialing routine will use the initialization text entered here
  1819.      before dialing the next telephone number.
  1820.  
  1821.      The dialing routine will use the exit text entered here before
  1822.      dialing a phone number. You can separate multiple exit commands
  1823.      with vertical bar (`|') characters.  Only the dialer will use them.
  1824.  
  1825. `Hang up command'
  1826.      The text to be sent to the modem when asked to hang up the line.
  1827.      This text does have to be present if the `Drop DTR on hangup'
  1828.      switch is enabled.
  1829.  
  1830.      By default `term' uses the following hang up command:
  1831.      `~~~~+++~~~~ATH0\r'.  This will cause `term' to wait exactly two
  1832.      seconds, to transmit the +++ escape sequence, wait another two
  1833.      seconds and eventually transmit the hangup-command.  The small
  1834.      delay before and after the escape sequence is necessary to put the
  1835.      modem into command state. The tilde characters are part of a set
  1836.      of special characters `term' uses, these do not get sent through
  1837.      to the modem. Specifically, each tilde character causes `term' to
  1838.      wait for half a second. For more information on the command
  1839.      sequences the tilde character belongs to see Command sequences.
  1840.  
  1841. `Do not send modem init/exit commands.'
  1842.      You may have placed special commands in the init/exit text fields
  1843.      that should be executed only when starting and terminating `term'.
  1844.      Still chances are that these will also get executed when the
  1845.      phonebook dialer dials the selected phonebook items unless you
  1846.      enable this switch.
  1847.  
  1848. `Command character send delay'
  1849.      You will only rarely use this feature. Some of the more modern
  1850.      high-speed modems with rather unreliable firmware which support
  1851.      baud rates of 28,800 bps and up cannot quite make sense of modem
  1852.      initialization and dialing commands if sent at this speed.
  1853.      However, small delays between the single characters sent to the
  1854.      modem can help. Just set the number of microseconds to wait here.
  1855.  
  1856. ``No carrier' message'
  1857.      The message the modem emits if the data carrier is lost. The
  1858.      program uses this to determine the length of the connection and to
  1859.      calculate how much the user is to pay for it.
  1860.  
  1861. ``No dialtone' message'
  1862.      The message to be returned by the modem in case it does not detect
  1863.      any dialing tone on the phone line.
  1864.  
  1865. ``Connect' message'
  1866.      The message the modem emits after detecting a carrier signal.
  1867.      `term' uses this input to determine successful telephone
  1868.      connection, to reconfigure itself and to start the online timer.
  1869.  
  1870. ``Voice' message'
  1871.      The message `term' is expected to receive if the modem detects a
  1872.      voice call. If in dialing mode, `term' will stop the process. The
  1873.      user will in any case be notified of the event.
  1874.  
  1875. ``Ring' message'
  1876.      The message the modem emits if it receives a call, same effects as
  1877.      with the `Voice' message.
  1878.  
  1879. ``Busy' message'
  1880.      The message the modem returns if the number which has just been
  1881.      dialed is busy.
  1882.  
  1883. ``Ok' message'
  1884.      The message the modem returns if a command was successfully
  1885.      executed.
  1886.  
  1887. ``Error' message'
  1888.      The message the modem returns if a command was not to be executed
  1889.      successfully.
  1890.  
  1891. `Dial command prefix'
  1892.      The text to be used to prefix each dialing command. By default
  1893.      `term' uses `ATD\w' as the prefix. This command contains the
  1894.      special escape sequence `\w' `term' will expand to either `T' or
  1895.      `P', depending on what the `Dial mode' switch is set to.
  1896.  
  1897. `Dial command suffix'
  1898.      The text to be used to append to each dialing command. This is
  1899.      usually the carriage-return character `\r'.
  1900.  
  1901. `Dial mode'
  1902.      This switch affects whether dialing commands will use touch tone or
  1903.      pulse dialing. Touch tone dialing usually is quite a bit faster
  1904.      than pulse dialing, but not all phone networks support it. This
  1905.      switch requires that either the dial prefix or dial suffix commands
  1906.      include the `\W' command sequence (see Command sequences).  By
  1907.      default `term' will use pulse dialing.
  1908.  
  1909. `PBX dial command'
  1910.      If you are dialing out through a PBX you may need to dial an extra
  1911.      number and wait a bit before dialing the rest of the phone number.
  1912.      Enter the extra number and any other special modem control
  1913.      characters here. By default `term' will use `0,,,' as the PBX dial
  1914.      command.  If enabled, this dial command is put between the `Dial
  1915.      prefix', the phone number to dial and the `Dial suffix'. The
  1916.      default command first dials a 0, then tells the modem to wait a
  1917.      bit (each comma causes the modem to wait for a small amount of
  1918.      time, see your modem manual for more information) for the dial
  1919.      tone to occur and eventually dials the rest of the phone number.
  1920.  
  1921.      Note that you may need to change the 0 to a 9 in the US.
  1922.  
  1923. `Use PBX dial command'
  1924.      This switch enables the PBX dial command describe above.
  1925.  
  1926. `Redial delay'
  1927.      The time to wait after walking through the whole dialing list
  1928.      without making any successful connection before another attempt is
  1929.      started.
  1930.  
  1931. `Dial retries'
  1932.      The number of times the dialer walks through the dialing list
  1933.      trying to make a successful connection before giving up. Setting
  1934.      this value to `unlimited' will cause the dialer to retry over and
  1935.      over again until it either makes a connection or the dialing
  1936.      procedure is aborted.
  1937.  
  1938. `Dial timeout'
  1939.      The time to wait for a successful connection during dialing. After
  1940.      this time has elapsed, the dialer will skip to the next entry in
  1941.      the list.
  1942.  
  1943. `Delay between calls'
  1944.      Some modems impose a limit on how many times you may dial out in a
  1945.      minute or just get hopelessly lost if dial commands come in in
  1946.      rapid succession. Here is where you set the time to wait between
  1947.      two successive calls. This value also has a profound effect on the
  1948.      redial delay which will be extended a bit if it is smaller than
  1949.      the delay between calls.
  1950.  
  1951. `Show modem responses'
  1952.      By default, `term' will not display any modem response text that is
  1953.      received while it is dialing. If you enable this switch no modem
  1954.      output will be swallowed, it will even find its way into the
  1955.      review buffer.
  1956.  
  1957. `Treat `NO CARRIER' as `BUSY''
  1958.      If this switch is in effect, the dialing function will treat the
  1959.      modem response code `NO CARRIER' exactly as the `BUSY' response
  1960.      code.
  1961.  
  1962. `Connect auto-baud'
  1963.      Most modems echo the baud rate upon successful connection. If
  1964.      enabled the baud rate will be read and set for the serial driver.
  1965.  
  1966.      *Use this feature with care as it may have certain negative
  1967.      side-effects (such as the modem dropping the line just after
  1968.      connecting to a BBS)!  If you happen to use a modern high-speed
  1969.      modem you will most certainly not need this feature. If in doubt
  1970.      whether you need to enable this feature you should rather disable
  1971.      it!*
  1972.  
  1973. `Dialer abort hangs up'
  1974.      Unless this switch is enabled the dialing procedure will try to
  1975.      stop a modem dial command by sending a plain carriage return
  1976.      character.  If the `Dialer abort hangs up' switch is enabled the
  1977.      usual modem hang up procedure will be used instead.
  1978.  
  1979. `Time to connect'
  1980.      `term' cannot measure the time to pass between the remote modem
  1981.      picking up the line and the local modem sending the `CONNECT'
  1982.      message. This slider allows to set the length of this interval.
  1983.      Upon connection, it will be added to the total online time.
  1984.  
  1985. `Drop DTR on hangup'
  1986.      Some modems will track the `data terminal ready' line in order to
  1987.      make sure that the terminal program is listening. Once the line
  1988.      goes back to low potential, these modems will drop the line and
  1989.      hang up. Use this button to make `term' take advantage of this
  1990.      feature.
  1991.  
  1992. `Redial after hanging up'
  1993.      If this switch is in effect, `term' will redial all the phone
  1994.      numbers still in the dialing list as soon as the line is hung up
  1995.      or the carrier signal is lost.
  1996.  
  1997. `Connect limit'
  1998.      This gauge is to set a certain period of time to be counted after
  1999.      a connection is made. When elapsed, a command sequence (see
  2000.      Command sequences) will be executed as to be set using the `Limit
  2001.      macro' settings. If set to `0:00' this function will be disabled.
  2002.  
  2003. `Limit macro'
  2004.      A command sequence to be triggered when the time to be set using
  2005.      the `Connect limit' gauge has elapsed. If no text is entered this
  2006.      function will be disabled.
  2007.  
  2008. `Use'
  2009.      Use the current settings.
  2010.  
  2011. `Default (phonebook only)'
  2012.      Drop the current settings, making a connection to the corresponding
  2013.      phone number will leave the corresponding main configuration entry
  2014.      unchanged.
  2015.  
  2016. `Cancel'
  2017.      Keep original settings.
  2018.  
  2019. Screen panel
  2020. ============
  2021.  
  2022. `Display mode'
  2023.      Choose the display mode `term' is to use for the main screen here.
  2024.  
  2025. `Screen font'
  2026.      This is where you choose the user interface font `term' is to use
  2027.      for the main screen.
  2028.  
  2029. `Faster layout'
  2030.      Activating this switch will slow down display updates and window
  2031.      management. Oh well, not always, there may be a speed increase with
  2032.      some configurations, such as with external emulations activated or
  2033.      when using more than four colours on the screen.
  2034.  
  2035.      I suggest to experiment with the effects of this button before
  2036.      actually using it permanently.
  2037.  
  2038. `Make screen public'
  2039.      If this switch is enabled, the `term' main screen will be made
  2040.      available as a public area other programs may open their windows
  2041.      on.
  2042.  
  2043. ``Shanghai' windows'
  2044.      This item, which is only displayed if `Make screen public' has been
  2045.      selected, is closely related to the function before. If active, all
  2046.      windows that will normally be displayed on the Workbench screen
  2047.      will open on the `term' main screen.
  2048.  
  2049. `Use public screen'
  2050.      `term' does not necessarily open a custom screen, this switch will
  2051.      make the main and auxilary windows appear on a named public
  2052.      screen. `term' will try to adapt colours and text rendering modes
  2053.      to its new environment. It will share the screen palette with
  2054.      other applications which makes it possible to run the built-in
  2055.      terminal emulation in eight or sixteen colours provided that
  2056.      enough shareable screen pens are available (note:  Kickstart 3.0
  2057.      required). `term' will inherit the text font to be used for user
  2058.      interface layout from the public screen it will open its window on.
  2059.  
  2060.      *Note:  only the built-in terminal emulation is guaranteed to take
  2061.      advantage of pen-sharing facilities, external emulation libraries
  2062.      will most likely fail to display text correctly!*
  2063.  
  2064.      Take care when resizing the `term' main window as a size change
  2065.      will reset the terminal emulation.
  2066.  
  2067. `Public screen name'
  2068.      The name of the public screen `term' is to open windows on. `term'
  2069.      will fall back to the Workbench screen if no proper name is given
  2070.      (i.e. no name is entered) or the desired screen is unavailable.
  2071.  
  2072. `Screen title'
  2073.      If this button is enabled, the `term' screen will contain a
  2074.      draggable title bar, if not, the title bar will be disabled,
  2075.      leaving more space for the terminal output window.
  2076.  
  2077. `Window border'
  2078.      The main window will be opened on a custom screen, featuring a
  2079.      drag bar and depth gadgets.
  2080.  
  2081. `Separate status window'
  2082.      A separate window will be opened for the status display window.
  2083.  
  2084. `Status line'
  2085.      This switch allows to disable the status line display or to change
  2086.      between two alternative status line displays:
  2087.  
  2088.     `Disabled'
  2089.           No status line is displayed.
  2090.  
  2091.     `Standard'
  2092.           The standard two status lines are displayed.
  2093.  
  2094.     `Compact'
  2095.           A very condensed version of the status line is displayed,
  2096.           only the data is shown but no captions. The data is displayed
  2097.           in the following order:
  2098.  
  2099.             1. Status
  2100.  
  2101.             2. Terminal type
  2102.  
  2103.             3. Transfer protocol
  2104.  
  2105.             4. Baud rate
  2106.  
  2107.             5. Serial parameters
  2108.  
  2109.             6. Time of day
  2110.  
  2111.             7. Online time
  2112.  
  2113. `Online display'
  2114.      This switch determines what type of information is to be displayed
  2115.      in the bottom right corner of the status display:
  2116.  
  2117.     `Online time'
  2118.           The time online
  2119.  
  2120.     `Online cost'
  2121.           The amount of money to be paid for the connection
  2122.  
  2123.     `Time & cost'
  2124.           Both time and money, the display will toggle between both of
  2125.           them every five seconds.
  2126.  
  2127. `Colour'
  2128.      This button determines the colour mode the terminal emulation is
  2129.      going to use. Until now, four modes have been implemented:
  2130.  
  2131.     `4 Colours (Amiga)'
  2132.           Four colours, optionally blinking.
  2133.  
  2134.     `8 Colours (ANSI)'
  2135.           Eight colours, optionally blinking.
  2136.  
  2137.     `16 Colours (EGA)'
  2138.           Sixteen colours, as the EGA-palette, optionally blinking.
  2139.  
  2140.     `2 Colours (Mono.)'
  2141.           Monochrome, two colours.
  2142.  
  2143. `Blinking'
  2144.      If selected the VT100 blinking option is enabled. This may require
  2145.      to allocate more colours for a specific colour mode than with
  2146.      blinking disabled, so do not be surprised if display performance
  2147.      suddenly drops like a brick.
  2148.  
  2149. `Palette'
  2150.      These buttons are used to select a colour of the screen palette
  2151.      that is to be changed.
  2152.  
  2153. `Red/Green/Blue'
  2154.      Use these sliders to modify the red, green and blue components of
  2155.      the currently active colour.
  2156.  
  2157. `Use default colours'
  2158.      Press this button to have the current colour palette set to the
  2159.      built-in default colours.
  2160.  
  2161. `Use standard pens'
  2162.      The user interface look is determined by the choice of on-screen
  2163.      rendering pens, i.e. which colour to use for highlighted text,
  2164.      active windows, inactive windows, etc. If this button is enabled
  2165.      the screen will be opened using a predefined standard set of
  2166.      drawing pens.
  2167.  
  2168. `Edit pens...'
  2169.      Pressing this button will open the pen panel (see Pen panel) which
  2170.      permits editing the drawing pens to use for this colour mode.
  2171.  
  2172. `Use'
  2173.      Use the current settings.
  2174.  
  2175. `Default (phonebook only)'
  2176.      Drop the current settings; making a connection to the corresponding
  2177.      phone number will leave the corresponding main configuration entry
  2178.      unchanged.
  2179.  
  2180. `Cancel'
  2181.      Keep the old settings.
  2182.  
  2183. Pen panel
  2184. =========
  2185.  
  2186.    *This control panel is available under Kickstart 3.0 and above only.
  2187. Its functionality is not supported under previous operating system
  2188. releases!*
  2189.  
  2190.    The user interface look is determined by the choice of on-screen
  2191. rendering pens, i.e. which colour to use for highlighted text, active
  2192. windows, inactive windows, etc. Changing the screen colour palette also
  2193. affects the look of the user interface, this control panel permits to
  2194. compensate for such changes: even if you reverse the terminal colours
  2195. you can still retain the correct user interface look by adapting the
  2196. pens. The controls available are similar to the Workbench Preferences
  2197. editor program `Palette':
  2198.  
  2199. `Background'
  2200.      The screen background colour to use, by default this is colour 0.
  2201.  
  2202. `Text'
  2203.      The default colour to render common text, such as in control panel
  2204.      labels.
  2205.  
  2206. `Important text'
  2207.      The colour to draw important text in, this should put a certain
  2208.      emphasis on the text rendered so the colour should be different
  2209.      from the `Text' colour.
  2210.  
  2211. `Bright edges'
  2212.      The colour to use to render the bright edges of windows.
  2213.  
  2214. `Dark edges'
  2215.      The colour to use to render the dark edges of windows.
  2216.  
  2217. `Active window title bars'
  2218.      The colour to mark the currently active window and selected
  2219.      buttons and list entries.
  2220.  
  2221. `Active window titles'
  2222.      The colour to use when printing text over active window title bars,
  2223.      selected buttons and list entries.
  2224.  
  2225. `Menu background'
  2226.      The colour to render pull-down menus in.
  2227.  
  2228. `Menu text'
  2229.      The colour to use when printing the menu text.
  2230.  
  2231. `Use standard pens'
  2232.      Reset the current pen selection to default values.
  2233.  
  2234. `Use'
  2235.      Keep the current settings.
  2236.  
  2237. `Cancel'
  2238.      Return to previous settings.
  2239.  
  2240. Terminal panel
  2241. ==============
  2242.  
  2243.    These settings control the basic behaviour of the terminal emulation
  2244. `term' uses. More specific emulation options are available in the
  2245. emulation window (see Emulation panel).
  2246.  
  2247. `Emulation'
  2248.      This is where you select the terminal emulation. Choose one of the
  2249.      following:
  2250.  
  2251.     `ANSI/VT220'
  2252.           This emulation is a `melange' of three terminal command sets
  2253.           which themselves are supersets or subsets of one another. Most
  2254.           of the VT220 command set is supported, including some
  2255.           additions made in the ANSI X3.64 specifications. With VT220
  2256.           its subsets VT100 and VT102 are supported. However, not all
  2257.           the VT52 commands are supported.
  2258.  
  2259.     `Atomic'
  2260.           A plain text-only terminal mode which filters out terminal
  2261.           commands and special control characters.
  2262.  
  2263.     `TTY'
  2264.           Also a text-only terminal mode but which displays all control
  2265.           codes and commands it cannot handle on-screen, great for
  2266.           debugging.
  2267.  
  2268.     `Hex'
  2269.           Another debugging mode which displays all incoming data in
  2270.           hexadecimal notation. If possible the corresponding glyphs
  2271.           will be displayed as well.
  2272.  
  2273.     `External'
  2274.           This enables the use of external terminal emulation libraries
  2275.           following the XEM v2.0 specifications. In this mode you need
  2276.           to specify the library to use, otherwise `term' will return to
  2277.           `ANSI/VT220' mode.
  2278.  
  2279. `Emulation name'
  2280.      The name of an external terminal emulation library to be used by
  2281.      `term' instead of the built-in emulation code. Requires that the
  2282.      emulation mode is set to `External'
  2283.  
  2284. `Bell'
  2285.      This is where you select the action(s) `term' is to take whenever a
  2286.      `bell' character turns up in the data stream:
  2287.  
  2288.     `Visual'
  2289.           The screen will flash.
  2290.  
  2291.     `Audible'
  2292.           An audible signal will be generated.
  2293.  
  2294.     `Visual & audible'
  2295.           A combination of both effects.
  2296.  
  2297.     `Ignore'
  2298.           Nothing will happen.
  2299.  
  2300.     `System default'
  2301.           The system beep routines will be used.
  2302.  
  2303. `Columns'
  2304.      The number of columns to use for the terminal window. The minimum
  2305.      value is 20 columns, the maximum value is defined by the actual
  2306.      screen size.
  2307.  
  2308. `Lines'
  2309.      The number of lines to use for the terminal window. The minimum
  2310.      value is 20 lines, the maximum value is defined by the actual
  2311.      screen size.
  2312.  
  2313. `Keymap file'
  2314.      If your installation requires that `term' is to use a custom keymap
  2315.      layout, enter the keymap file name here.
  2316.  
  2317.      *At the time of this writing the program will not support custom
  2318.      keymap layouts with the packet window (see Packet window) due to
  2319.      operating system limitations.*
  2320.  
  2321. `Use emulation process'
  2322.      If you are bold and daring you can have an external process handle
  2323.      the terminal text output, just turn on this switch. Please note
  2324.      that the external process will consume additional memory and text
  2325.      throughput speed is likely to suffer with fragmented memory. On
  2326.      the other hand the emulation process will relieve the main program
  2327.      of the tedious task of having to process the incoming data which.
  2328.      This helps the main program to keep up with the incoming data
  2329.      stream and makes it less likely that incoming text is lost.
  2330.  
  2331. `Text font'
  2332.      The name of the standard or default terminal text display font.
  2333.      Please note that this font cannot be proportional-spaced.
  2334.  
  2335. `IBM PC font'
  2336.      The name of the font to use if the terminal is in IBM PC mode.
  2337.      Please note that this font cannot be proportional-spaced.
  2338.  
  2339. `Font'
  2340.      Here the type of the font to be used for text display in the
  2341.      terminal window can be selected:
  2342.  
  2343.     `Standard'
  2344.           The standard text font selected under the `Text font' settings
  2345.           in this control panel.
  2346.  
  2347.     `IBM PC style'
  2348.           A font similar to the IBM PC text font will be used. No
  2349.           matter how the translation tables (see Translation panel) are
  2350.           configured, outgoing Amiga characters are translated into PC
  2351.           character values. The terminal window will use the font
  2352.           selected under the `IBM PC font' settings in this control
  2353.           panel.
  2354.  
  2355.     `IBM PC style (raw)'
  2356.           This selection has very much the same effect as `IBM PC
  2357.           style' but no character translation is performed. The terminal
  2358.           window will use the font selected under the `IBM PC font'
  2359.           settings in this control panel.
  2360.  
  2361. `Send CR'
  2362. `Send LF'
  2363.      These buttons determine the sequences that are sent to the remote
  2364.      if a carriage return (CR) or line feed (LF) character is to be
  2365.      transmitted.  Both characters serve as end-of-line indicators.
  2366.  
  2367.     `-'
  2368.           The character is suppressed.
  2369.  
  2370.     `<<CR>>'
  2371.           A carriage return character is sent.
  2372.  
  2373.     `<<LF>>'
  2374.           A line feed character is sent.
  2375.  
  2376.     `<<CR>><<LF>>'
  2377.           A sequence of two characters (carriage return followed by
  2378.           line feed) is sent.
  2379.  
  2380.     `<<LF>><<CR>>'
  2381.           A sequence of two characters (line feed followed by carriage
  2382.           return) is sent.
  2383.  
  2384. `Receive CR'
  2385. `Receive LF'
  2386.      These two buttons have largely the same effect as the `Send CR/LF'
  2387.      buttons, they are different in that they affect the incoming data
  2388.      rather than the data transmitted.
  2389.  
  2390. `Use'
  2391.      Use the current settings.
  2392.  
  2393. `Default (phonebook only)'
  2394.      Drop the current settings, making a connection to the corresponding
  2395.      phone number will leave the corresponding main configuration entry
  2396.      unchanged.
  2397.  
  2398. `Cancel'
  2399.      Keep the old settings.
  2400.  
  2401. Emulation panel
  2402. ===============
  2403.  
  2404.    The buttons found here allow you to change the internal parameters of
  2405. the selected emulation.
  2406.  
  2407.    The following text only describes the parameters to change when using
  2408. the built-in terminal emulation; if an external terminal emulation is in
  2409. effect, this menu will conjure up the corresponding parameters menu as
  2410. supported by the external terminal emulation module.
  2411.  
  2412. `Cursor keys'
  2413.      If in `applications mode' the cursor keys will cause a command
  2414.      sequence to be transmitted instead of a cursor move event. This
  2415.      mode is usually activated by special applications on the remote
  2416.      side.
  2417.  
  2418. `Lock cursor key mode'
  2419.      Certain applications may excessively change the cursor key mode
  2420.      from standard to applications mode. If you do not want this to
  2421.      happen you can forbid it by using this switch.
  2422.  
  2423. `Numeric keypad'
  2424.      If in `applications mode' the numeric keypad will cause a command
  2425.      sequence to be transmitted instead of the characters indicated by
  2426.      the key labels.  This mode is usually activated by special
  2427.      applications on the remote side.
  2428.  
  2429. `Lock keypad mode'
  2430.      Certain applications may excessively change the keypad mode from
  2431.      standard to applications mode. If you do not want this to happen
  2432.      you can forbid it by using this switch.
  2433.  
  2434. `Swap [Backspace] and [Del] keys'
  2435.      If this switch is in effect the backspace and delete key codes are
  2436.      swapped. *This also applies to sequences such as `Control + H'
  2437.      which will produce a delete character instead of a backspace
  2438.      character.*
  2439.  
  2440. `Terminal identifies as'
  2441.      If the remote application requests that `term' identify itself,
  2442.      stating which terminal it emulates, `term' can respond with
  2443.      various identification signatures. It can identify itself as being
  2444.      a DEC VT200, VT102, VT101 or VT100 terminal. You may only rarely
  2445.      want to change this option, it is mainly used to trick old or
  2446.      not-quite-that-well-behaved applications into being a little
  2447.      friendlier towards the `term' terminal emulation.
  2448.  
  2449.      Note: this switch does not affect how `term' operates, it only
  2450.      changes the signature `term' responds with when asked to identify
  2451.      itself, i.e.  even if you switch to VT100, `term' will still
  2452.      understand and process VT220 specific commands.
  2453.  
  2454. `BBS-ANSI compliant'
  2455.      This is not an option like the others in this settings editor, it
  2456.      is merely a shortcut to enable all options in this editor that are
  2457.      required to make `term' behave like a BBS-ANSI compliant terminal.
  2458.      In addition to that you may need to change the terminal settings
  2459.      as well. For BBS-ANSI compliance, the terminal settings need to be
  2460.      changed to use a 80 columns by 25 lines sized terminal window and
  2461.      the IBM PC style font.
  2462.  
  2463. `Wrap characters'
  2464.      This function activates the automatical carriage return function
  2465.      which is triggered as soon as the cursor crosses the right screen
  2466.      margin. To avoid unpleasant side-effects, this switch should be
  2467.      activated all the time.
  2468.  
  2469. `Lock line wrapping'
  2470.      If this switch is enabled, any requests to change the end of line
  2471.      text wrapping mode will be rejected.
  2472.  
  2473. `Insert mode'
  2474.      Normally, `term' is in overwrite-mode (characters entered
  2475.      overwrite the contents of the screen). If this gadget is
  2476.      activated, typed characters are inserted by pushing all the
  2477.      characters right of the cursor towards the right margin.
  2478.  
  2479.      *The insert-mode does only work for lines. If characters are
  2480.      pushed out of the screen they cannot be restored.*
  2481.  
  2482. `New-line mode'
  2483.      This gadget activates a special mode in which some VT100 control
  2484.      sequences cause `term' to perform a linefeed instead of clearing
  2485.      the screen or other serious changes of the contents of the screen.
  2486.  
  2487. ``CLS' resets cursor position'
  2488.      As per the VT100 specs, the control sequence to clear the screen is
  2489.      not to change the current cursor position. However, several
  2490.      applications expect it to be moved to the top left corner of the
  2491.      screen. This button will activate this behaviour.
  2492.  
  2493. `Printer control enabled'
  2494.      `term' supports the standard VT220 printer control commands. If you
  2495.      do not want the remote application to play with the printer the
  2496.      corresponding support commands can be disabled with this switch.
  2497.      If disabled `term' will act like a VT220 terminal with no printer
  2498.      attached.
  2499.  
  2500. `Lock text style'
  2501.      If this switch is enabled, any requests to change the text
  2502.      rendering attributes (underlined, highlight, blinking, inverse)
  2503.      will be rejected.
  2504.  
  2505. `Lock text colour'
  2506.      If this switch is enabled, any requests to change the text
  2507.      rendering colour will be rejected.
  2508.  
  2509. `Wrap cursor moves'
  2510.      According to the VT-100 specifications the cursor movements have
  2511.      to stop at the edges of the screen. In spite of this the cursor
  2512.      may leave these borders, especially in ANSI-mode, and may appear
  2513.      at the other side of the screen. This button activates a more
  2514.      `tolerant' mode.
  2515.  
  2516. `Lock font mode'
  2517.      If this switch is turned on, any terminal commands to change the
  2518.      font scale will be ignored.
  2519.  
  2520. `Scrolling'
  2521.      This button selects one of two different scrolling modes: smooth or
  2522.      jumping.
  2523.  
  2524. `Destructive backspace'
  2525.      Determines if the `Backspace' code, which will delete the character
  2526.      left from the cursor, only moves the cursor to the left or removes
  2527.      the character from the screen. `Off' turns this feature off,
  2528.      `Overstrike' clears the character below the cursor and `Shift'
  2529.      shifts the line contents to the right of the cursor to the left.
  2530.  
  2531. `Answerback message'
  2532.      The text to send across the serial line whenever an `ENQ'
  2533.      character is received. The text is - as usual - a command sequence.
  2534.  
  2535. `Maximum prescroll lines'
  2536.      This is where you set the maximum number of lines the terminal
  2537.      emulation will scroll the screen contents up in one single `jump'.
  2538.      This feature is often referred to as `prescroll'.  *Note: the data
  2539.      throughput rate plays an important part when counting the number
  2540.      of lines to scroll. The higher the rate, the more lines will be
  2541.      scrolled.*
  2542.  
  2543. `Maximum scroll jump'
  2544.      Here is where you set the number of lines to move the screen
  2545.      contents up when the cursor moves beyond the last terminal screen
  2546.      line.
  2547.  
  2548. `Use standard pens'
  2549.      The built-in terminal emulation makes use of up to sixteen text
  2550.      rendering pens and four text rendering attributes. For each colour
  2551.      mode supported (see Screen panel) a specific pen order and text
  2552.      attribute assignment is predefined. You can select your own pen
  2553.      order and attribute assignment if this switch is not enabled by
  2554.      pressing the button labeled `Edit pens...'.
  2555.  
  2556. `Edit pens...'
  2557.      Pressing this button will open the text pen panel (see Textpen
  2558.      panel) which permits editing the drawing pens to use for this
  2559.      colour mode.
  2560.  
  2561. `Use'
  2562.      Use the current settings.
  2563.  
  2564. `Default (phonebook only)'
  2565.      Drop the current settings, making a connection to the corresponding
  2566.      phone number will leave the corresponding main configuration entry
  2567.      unchanged.
  2568.  
  2569. `Cancel'
  2570.      Keep the old settings.
  2571.  
  2572. Textpen panel
  2573. =============
  2574.  
  2575.    For each colour mode (monochrome, 4, 8, 16 colours) the terminal
  2576. emulation uses a specific order of text pens and text attribute
  2577. assignments.  The text pens determine which text rendering colours to
  2578. use. The text attribute assignments define how blinking, inverse,
  2579. underlined and highlighted text should be displayed. This control panel
  2580. is divided into two parts. One part serves to select the text pens, the
  2581. other part will let you assign the text attributes. At the left hand
  2582. side of each control you will find a label which indicates the
  2583. emulation's default value.
  2584.  
  2585.    There is a limitation in the number of text colour you can choose.
  2586. While there is a colour mode which makes use of 16 colours, only a
  2587. maximum of eight colours can be selected. The reason for this
  2588. limitation is found in the terminal control commands which allow for
  2589. only eight colours (0-7). The remaining eight colours (8-15) are
  2590. selected via a text rendering attribute, known as `highlight'.  This
  2591. means, if text is to be printed in colour 7 and the highlight text
  2592. rendering attribute is enabled the text will be printed in colour 15.
  2593. The `highlight' text rendering attribute always has a special meaning.
  2594. In all colour modes except 16 it causes text to be output in boldface.
  2595.  
  2596. `Drawing pens'
  2597.      Here you select the text drawing pen order to use.
  2598.  
  2599. `Attributes'
  2600.      Here you select which text rendering attribute to use instead of
  2601.      the default. You can also choose to disable an attribute.
  2602.  
  2603. Clipboard panel
  2604. ===============
  2605.  
  2606. `Clipboard unit'
  2607.      The clipboard supports several units (0-255) which can be accessed
  2608.      independently. It can make sense to change this value but
  2609.      generally you will probably leave it as unit `0'.
  2610.  
  2611. `Paste prefix'
  2612.      If enabled, the text to send before the clipboard contents are fed
  2613.      into the input stream, see Clipboard.
  2614.  
  2615. `Paste suffix'
  2616.      If enabled, the text to send after the clipboard contents are fed
  2617.      into the input stream, see Clipboard.
  2618.  
  2619. `Convert <<LF>> to <<CR>>'
  2620.      On the Amiga, new lines end with the LF (line feed) character. To
  2621.      simulate typed text, these characters should be converted to CR
  2622.      (carriage return characters) when pasting the contents of the
  2623.      clipboard. If this switch is enabled, the conversion will take
  2624.      place.
  2625.  
  2626. `Text pacing'
  2627.      The mode to determine how text is sent to the remote:
  2628.  
  2629.     `Direct'
  2630.           Each line will be sent without any delay.
  2631.  
  2632.     `Wait for echo'
  2633.           The program will wait for each single character sent to be
  2634.           echoed by the remote.
  2635.  
  2636.     `Wait for any echo'
  2637.           The program will wait for the remote to return any character
  2638.           in response to any character sent. Typically, this is the case
  2639.           with password prompts issued by BBSes.
  2640.  
  2641.     `Wait for line prompt'
  2642.           The program will wait until the remote sends a certain line
  2643.           prompt text.
  2644.  
  2645.     `Character/line delay'
  2646.           The program will respect the character/line delay values to
  2647.           be set using this control panel.
  2648.  
  2649.     `Keyboard delay'
  2650.           The program will send character separated by a delay to be
  2651.           determined by the current system keyboard repeat delay.
  2652.  
  2653.      *Note: the `echo' text pacing modes are to be used with greate
  2654.      care. Certain online services do not echo characters back to the
  2655.      sender as they run only in half-duplex mode.  On the other hand
  2656.      most BBS programs will not echo certain characters, such as escape
  2657.      codes, etc.*
  2658.  
  2659. `Character delay'
  2660.      When sending text this number determines how many seconds to wait
  2661.      before sending the next character.
  2662.  
  2663. `Line delay'
  2664.      When sending text this number determines how many seconds to wait
  2665.      before sending the line-termination character (carriage return).
  2666.  
  2667. `Line prompt'
  2668.      The character(s) to wait for the receiver to issue after a line of
  2669.      text is send. This text may include command sequence tokens.
  2670.  
  2671. `Send timeout'
  2672.      If the `Text pacing' mode is set to  `Wait for echo' or `Wait for
  2673.      line prompt' the maximum time to wait for echo/prompt before the
  2674.      insertion is aborted.
  2675.  
  2676. `Use'
  2677.      Use the current settings.
  2678.  
  2679. `Default (phonebook only)'
  2680.      Drop the current settings, making a connection to the corresponding
  2681.      phone number will leave the corresponding main configuration entry
  2682.      unchanged.
  2683.  
  2684. `Cancel'
  2685.      Keep the old settings.
  2686.  
  2687. Capture panel
  2688. =============
  2689.  
  2690. `Log actions'
  2691.      If enabled will write a protocol of each program action (uploads,
  2692.      downloads, dial attempts, etc.) to a file. Each action is listed
  2693.      along with time and date. Carrier-lost events will also note the
  2694.      approximate cost of the call. The log file created by this
  2695.      function is *not intended* for postprocessing via call-log file
  2696.      analyzers. Use the `Log calls' feature for this purpose.
  2697.  
  2698. `Log file'
  2699.      The name of the file in which the information on the actions
  2700.      executed by `term' will be stored if `Log actions' is enabled.
  2701.  
  2702. `Log calls'
  2703.      If this switch is enabled, `term' will create call-log files in a
  2704.      format compatible with the `CallInfo' program. Sometimes this
  2705.      format is referred to as `NComm format'.
  2706.  
  2707. `Call log file'
  2708.      The name of the file in which the information on calls made by
  2709.      `term' will be stored if `Log calls' is enabled.
  2710.  
  2711. `Connect-auto-capture'
  2712.      If enabled will automatically open a capture file after
  2713.      successfully making a connection. Any other already open capture
  2714.      file will be closed before proceeding. The files created will bear
  2715.      the names of the corresponding phonebook entries.
  2716.  
  2717. `Filter enabled'
  2718.      If selected, command sequences are filtered out before the incoming
  2719.      characters are captured to disk or printer. This makes good sense
  2720.      with noisy lines generating random characters which might scare
  2721.      your printer. It also produces a text file that is much more
  2722.      readable than with all the control sequence codes cluttering up
  2723.      the text.
  2724.  
  2725. `Convert characters'
  2726.      This switch works in conjunction with the `Filter enabled' option.
  2727.      When using the `IBM PC style' terminal font, `term' receives
  2728.      characters which normally do not have a place in the standard
  2729.      Amiga character set. If the `Convert characters' switch is
  2730.      enabled, these characters will be converted into their Amiga
  2731.      equivalents, if there are any, before they go into the capture
  2732.      buffer. Note that this character conversion is always enabled for
  2733.      text captured to the printer.
  2734.  
  2735. `Creation date'
  2736.      By default `term' will append the date of the call made to the
  2737.      name of the auto-capture file created (`Add to name').
  2738.      Alternatively, `term' will leave the name untouched and store the
  2739.      creation date within the file (`Write to file').
  2740.  
  2741. `File drawer'
  2742.      This text gadget contains the path in which the the capture files
  2743.      will be created if `Connect-auto-capture' is enabled.
  2744.  
  2745. `Enabled'
  2746.      This switch works in conjunction with the `Freeze buffer' menu
  2747.      entry (freezing the text buffer contents). In fact, the menu entry
  2748.      is adjusted according to the configuration settings whenever a new
  2749.      configuration is invoked (that is, whenever a new connection is
  2750.      made through the dialing panel or at program startup time). *`term'
  2751.      will only freeze the buffer if this switch is set, it will leave
  2752.      the buffer state (frozen or not) untouched if this switch is not
  2753.      enabled.*
  2754.  
  2755. `Maximum size'
  2756.      To save memory, a high-water mark concerning the maximum amount of
  2757.      memory the text buffer (see Text buffer) will allocate for text
  2758.      may be specified.  The minimum value to be entered here is 2,000
  2759.      bytes which are roughly equivalent to two text buffer pages of
  2760.      text. A value of 0 will cause the text buffer to always allocate
  2761.      as much memory as required to buffer all the incoming text.
  2762.  
  2763. `File drawer'
  2764.      The path the file requester will bring up when saving the contents
  2765.      of the text buffer.
  2766.  
  2767. `Line width'
  2768.      The text buffer stores lines at a fixed size, this slider
  2769.      determines the maximum line width.
  2770.  
  2771. `Buffer operation mode'
  2772.      The incoming data can be stored in the buffer in two different
  2773.      ways. The default is to filter out control sequences but largely
  2774.      to store the text as it came in (this is the `Data flow' mode); if
  2775.      the same text is printed over and over again in the same line, it
  2776.      will show up more than once in the text buffer. The alternative is
  2777.      the `Review' mode in which the text is stored right as it appears
  2778.      on the screen. Although this is more faithful to the general
  2779.      concept of the review buffer, this has its drawbacks; text will
  2780.      only appear in the buffer when it has either scrolled out of view
  2781.      or if the screen gets cleared.
  2782.  
  2783. `Open window'
  2784.      This switch controls which part of the text buffer contents the
  2785.      review buffer window will display when opened:
  2786.  
  2787.     `Top'
  2788.           Displays the top of the buffer contents.
  2789.  
  2790.     `End'
  2791.           Displays the end of the buffer contents.
  2792.  
  2793. `Remember position'
  2794.      If this switch is in effect, the program will remember the text
  2795.      display position between calls rather than jumping to the top or
  2796.      the end of the text buffer.
  2797.  
  2798. `Open screen'
  2799.      This switch controls which part of the text buffer contents the
  2800.      review buffer screen will display when opened:
  2801.  
  2802.     `Top'
  2803.           Displays the top of the buffer contents.
  2804.  
  2805.     `Remember'
  2806.           Keeps the previous buffer position.
  2807.  
  2808.     `End'
  2809.           Displays the end of the buffer contents.
  2810.  
  2811. `Remember position'
  2812.      If this switch is in effect, the program will remember the text
  2813.      display position between calls rather than jumping to the top or
  2814.      the end of the text buffer.
  2815.  
  2816. `Screen position'
  2817.      The buffer screen will usually not be quite as wide as the system
  2818.      overscan settings permit. This switch determines the horizontal
  2819.      placement of the screen:
  2820.  
  2821.     `Left'
  2822.           The screen will be left-edge aligned.
  2823.  
  2824.     `Centre'
  2825.           The screen will be centred.
  2826.  
  2827.     `Right'
  2828.           The screen will be right-edge aligned. This will bring the
  2829.           screen depth arrangement gadget in line with the other
  2830.           screens.
  2831.  
  2832. `Display mode'
  2833.      This is where you choose the screen display mode the buffer screen
  2834.      should use.
  2835.  
  2836. `Search history size'
  2837.      The text buffer search function maintains a backlog of all the
  2838.      search text entered. The number of texts to remember, before the
  2839.      oldest is discarded, can be set using the `Search history size'
  2840.      control. In the search text entry field you can use the `Cursor
  2841.      up' and `Cursor down' keys to scroll through the previously
  2842.      entered search strings.
  2843.  
  2844. `Use'
  2845.      Use the current settings.
  2846.  
  2847. `Default (phonebook only)'
  2848.      Drop the current settings, making a connection to the corresponding
  2849.      phone number will leave the corresponding main configuration entry
  2850.      unchanged.
  2851.  
  2852. `Cancel'
  2853.      Keep the old settings.
  2854.  
  2855. Command panel
  2856. =============
  2857.  
  2858.    Here you will find entries for four command sequences which serve
  2859. four functions:
  2860.  
  2861. `Startup command'
  2862.      At the beginning of every session with `term' and after a
  2863.      connection has been established by the dialing routine a
  2864.      command-sequence is executed.  Do not use this command for
  2865.      auto-login scripts and such, this is what the `Login command' is
  2866.      for. Note that the dialing procedure executes the `Startup
  2867.      command' after the `Login command'.
  2868.  
  2869. `Login command'
  2870.      This command will be executed immediately after the dialing
  2871.      procedure has established a connection. You should use this
  2872.      command for login scripts and such. Note that the dialing
  2873.      procedure first executes the `Login command' and then the `Startup
  2874.      command'.
  2875.  
  2876. `Logoff command'
  2877.      The command to execute when the line is hung up or the carrier
  2878.      signal is lost.
  2879.  
  2880. `Upload command'
  2881.      `term' will execute this command after a successful upload has
  2882.      been made.
  2883.  
  2884. `Download command'
  2885.      `term' will execute this command after a successful download has
  2886.      been made.
  2887.  
  2888. `Use'
  2889.      Use the current settings.
  2890.  
  2891. `Default (phonebook only)'
  2892.      Drop the current settings, making a connection to the corresponding
  2893.      phone number will leave the corresponding main configuration entry
  2894.      unchanged.
  2895.  
  2896. `Cancel'
  2897.      Keep the old settings.
  2898.  
  2899. Miscellaneous panel
  2900. ===================
  2901.  
  2902.    This is the place where options can be set which would not fit into
  2903. other control panels
  2904.  
  2905. `Backup configuration'
  2906.      By default the local program configuration saved along with a
  2907.      phonebook entry will replace the global configuration as soon as a
  2908.      successful connection is made. If this switch is enabled, `term'
  2909.      will remember the global configuration in effect before the
  2910.      configuration data of a phonebook entry is adopted. As soon as the
  2911.      serial driver loses track of the carrier signal or the user
  2912.      chooses to hang up the line, `term' will restore the previous
  2913.      global configuration.
  2914.  
  2915. `Show fast! macros'
  2916.      If this switch is enabled, the fast macro window (see Fast macro
  2917.      panel) will be opened whenever the current configuration becomes
  2918.      active (e.g. at startup time). Please note that if this switch is
  2919.      not enabled, this does not cause the fast macro window to be
  2920.      closed.
  2921.  
  2922. `Release serial device when iconified'
  2923.      By default the serial device driver is released when `term' is
  2924.      iconified. Unfortunately, some modems drop the line when the
  2925.      device is closed so this switch allows you to keep the link.
  2926.  
  2927. `Simple file I/O'
  2928.      This switch controls whether `term' is to use double-buffered file
  2929.      management routines or not.
  2930.  
  2931. `Protective mode'
  2932.      With this switch enabled `term' tries to be nice and will notify
  2933.      you in case file/drawer/program names you have entered probably are
  2934.      invalid, data was not saved when the program is to be terminated,
  2935.      files are about to get overwritten and also if some program
  2936.      settings combinations are likely to cause trouble. Some users may
  2937.      find this appealing, while some may find it appaling.
  2938.  
  2939. `Create icons'
  2940.      If this switch is in effect `term' will try to provide icons for
  2941.      all files it receives. The following file types (and the
  2942.      corresponding icon files) are supported:
  2943.  
  2944.     *Text file
  2945.           icon `ENV:sys/def_text.info'
  2946.  
  2947.     *Sound file
  2948.           icon `ENV:sys/def_sound.info'
  2949.  
  2950.     *Picture file
  2951.           icon `ENV:sys/def_picture.info'
  2952.  
  2953.     *Tool
  2954.           icon `ENV:sys/def_tool.info'
  2955.  
  2956.     *Archive file
  2957.           icon `ENV:sys/def_archive.info'
  2958.  
  2959.     *Preferences file
  2960.           icon `ENV:sys/def_pref.info'
  2961.  
  2962.     *Other file types
  2963.           icon `ENV:sys/def_project.info'
  2964.  
  2965.      Text and pictures saved by the program will also get icons
  2966.      attached.
  2967.  
  2968. `Program priority'
  2969.      Use this slider to determine the priority under which the `term'
  2970.      main process is to operate. Adjusting this value can make `term'
  2971.      perform more reliably in a system which experiences heavy task
  2972.      loading. It is recommended to experiment with this value until a
  2973.      satisfactory state is found.  Setting the program priority too
  2974.      high or too low may affect the performance of coprocess services
  2975.      such as the double-buffered file I/O routines.
  2976.  
  2977. `I/O buffer size'
  2978.      This slider controls how much memory the double-buffered file
  2979.      management routines will allocate for each buffer. This means a
  2980.      value of 4096 bytes will result in an allocation of 8192 bytes in
  2981.      total.
  2982.  
  2983. `Alert'
  2984.      `term' notifies the user of certain events, such as a connection
  2985.      being established or a file transfer action which has just been
  2986.      finished.  This switch allows you to select the type of
  2987.      notification:
  2988.  
  2989.     `Bell'
  2990.           A bell signal will be given.
  2991.  
  2992.     `Screen'
  2993.           The `term' screen will be brought to the front.
  2994.  
  2995.     `Bell & Screen'
  2996.           A combination of the two actions above.
  2997.  
  2998.     `None'
  2999.           Nothing will happen.
  3000.  
  3001.     `Requester dimensions'
  3002.           File, font and screen display mode requesters can be made to
  3003.           appear at specific positions and in specific sizes on the
  3004.           screen. This switch controls how they should appear:
  3005.          `Ignore'
  3006.                The default position and size won't be touched.
  3007.  
  3008.          `Centre'
  3009.                The requester will be centered within the limits of the
  3010.                main window.
  3011.  
  3012.          `Relative'
  3013.                The requester will appear at a specific position
  3014.                relative to the top left corner of the main window.
  3015.  
  3016.     `Edit...'
  3017.           Pressing this button opens a standard file requester,
  3018.           prompting you to resize and move the window to a position
  3019.           where you want to have it appear the next time it is opened.
  3020.           Click on the `Use' button when finished.
  3021.  
  3022. `Use'
  3023.      Use the current settings.
  3024.  
  3025. `Default (phonebook only)'
  3026.      Drop the current settings, making a connection to the corresponding
  3027.      phone number will leave the corresponding main configuration entry
  3028.      unchanged.
  3029.  
  3030. `Cancel'
  3031.      Keep the old settings.
  3032.  
  3033. Path panel
  3034. ==========
  3035.  
  3036.    In this part of the settings all paths, which `term' uses to save or
  3037. load any data, can be determined.
  3038.  
  3039. `...Upload drawer'
  3040. `...Download drawer'
  3041.      The directories in which the functions contained in the `Transfer'
  3042.      menu will search and create files.
  3043.  
  3044. `Configuration storage drawer'
  3045.      The drawer that will contain all configuration files (phonebook,
  3046.      macro keys, etc.). The default configuration file is called
  3047.      `term.prefs' and will be searched in the path defined by the
  3048.      enviroment variable `TERMCONFIGPATH' (see Environment variables).
  3049.  
  3050. `Default text editor'
  3051.      Contains the name and search path of the editor used by `Edit &
  3052.      upload text file' in the transfer menu (see Transf.).
  3053.  
  3054. ``term' help text file'
  3055.      This is where the name of the online-help text file is stored. By
  3056.      default this is `PROGDIR:term.guide'.
  3057.  
  3058. `Use'
  3059.      Use the current settings.
  3060.  
  3061. `Default (phonebook only)'
  3062.      Drop the current settings, making a connection to the corresponding
  3063.      phone number will leave the corresponding main configuration entry
  3064.      unchanged.
  3065.  
  3066. `Cancel'
  3067.      Keep the old settings.
  3068.  
  3069. Transfer panel
  3070. ==============
  3071.  
  3072.    This is where the protocols to be employed for file transfers are to
  3073. be selected. You will also find a handful of additional options here
  3074. which one way or the other fit into the cathegory of file transfer
  3075. related data.
  3076.  
  3077. `Override transfer drawer'
  3078.      Each batch file transfer protocol allows you to specify the name
  3079.      of the drawer to place the files it receives in. By default `term'
  3080.      will redirect the files to a drawer to be specified in the path
  3081.      panel (see Path panel). If this switch is disabled, the internal
  3082.      settings of the current transfer protocol will be used. This may
  3083.      cause files to appear (or rather disappear) in the wrong drawers.
  3084.  
  3085.      Note: if you turn on this switch, `term' will deny the file
  3086.      transfer protocol to delete any files as it may remove them from
  3087.      the wrong drawer.
  3088.  
  3089. `Set `archived' bit'
  3090.      If enabled, this switch will cause `term' to mark files sent as
  3091.      `archived'.
  3092.  
  3093. `Transfer file icons'
  3094.      This switch works in conjunction with the drag & upload feature
  3095.      (see Transfer progress panel). By default, `term' will upload only
  3096.      the files whose icons are dragged on the main window or found in
  3097.      the upload queue. If this switch is in effect the icon files will
  3098.      be transferred as well.
  3099.  
  3100. `Mangle filenames for upload'
  3101.      Certain transfer protocols running under MS-DOS get into serious
  3102.      trouble if told to receive files with names which do not match the
  3103.      local naming scheme (8 characters for the name + "." + 3
  3104.      characters for the extension). For example, in such situations
  3105.      ZModem will restart the file transfer over and over again in a row
  3106.      without getting anywhere. To steer clear of trouble you can turn
  3107.      on the `Mangle filenames for upload' switch which will cause the
  3108.      file transfer protocol to report `condensed' file names to the
  3109.      remote receiver.  A special algorithm will shrink the file names
  3110.      to the MS-DOS file name template, clearing potentially dangerous
  3111.      character combinations on the fly. This switch has no effect on
  3112.      external programs. *Note: the algorithm may map two different
  3113.      Amiga file names to the same MS-DOS file name, so watch out!*
  3114.  
  3115. `Transfer performance meter'
  3116.      When a file transfer is running, `term' may optionally display the
  3117.      file transfer performance in a small resizable window. The lines
  3118.      drawn represent the following information:
  3119.  
  3120.     *Black line
  3121.           This line displayes the current transfer performance (usually
  3122.           heavily oscillating).
  3123.  
  3124.     *Blue line
  3125.           This line displays the average transfer performance.
  3126.  
  3127.     *White line
  3128.           This line displays the smallest transfer performance (should
  3129.           be constant during the transfer).
  3130.  
  3131. `Hide upload icon'
  3132.      The file upload panel can be invoked by double-clicking on the
  3133.      corresponding icon placed in the Workbench window (see File upload
  3134.      panel). If you do not want the icon to apear, turn on the `Hide
  3135.      upload icon' switch.
  3136.  
  3137. `Notify user after <n> errors have occured'
  3138.      Here you select after how many file transfer errors you want to be
  3139.      notified. The errors are counted separately for each file. When the
  3140.      given number of errors have accumulated, an error notification
  3141.      sound will be played. Setting this value to 0 suppresses this
  3142.      feature.
  3143.  
  3144. `Notify user'
  3145.      This switch controls when the file transfer window should be
  3146.      brought the front and a notification sound should be played:
  3147.  
  3148.     `only when an error occurs'
  3149.           The `term' screen and the file transfer window will stay in
  3150.           the background until a serious problem occurs.
  3151.  
  3152.     `when transfer begins/ends'
  3153.           Screen and window will be brought to the front at the
  3154.           beginning and at the end of a transfer.
  3155.  
  3156.     `when transfer begins'
  3157.           Screen and window will be brought to the front at the
  3158.           beginning of a transfer.
  3159.  
  3160.     `when transfer ends'
  3161.           Screen and window will be brought to the front at the end of
  3162.           a transfer.
  3163.  
  3164. `File comment'
  3165.      This is where the action to perform on downloaded files can be set:
  3166.  
  3167.     `Ignore'
  3168.           The file comment will not be touched.
  3169.  
  3170.     `File type'
  3171.           The file will be examined and a guess will be made which type
  3172.           of file it is. The file comment will be set to the name of
  3173.           the file type.
  3174.  
  3175.     `Source and time'
  3176.           The current BBS name and the time the file was received are
  3177.           placed in the file comment.
  3178.  
  3179.     `Default protocol'
  3180.           Select your most often used file transfer protocol here, make
  3181.           individual changes to the ASCII, text and binary transfer
  3182.           protocols only if you really need them. Most users may never
  3183.           need a different transfer protocol than the default protocol.
  3184.           The default protocol will also handle automatic invocation of
  3185.           downloads if necessary.
  3186.  
  3187.          `Type'
  3188.                You can either select `XPR library' or `External program'
  3189.                here.
  3190.  
  3191.                `XPR library' will use an external transfer protocol
  3192.                library, such as `xprzmodem.library'. This library will
  3193.                be kept open all the time and may for example handle
  3194.                download session automatically.  For more information on
  3195.                how to use XPR libraries see Data transfer via XPR
  3196.                library.
  3197.  
  3198.                `External program' will invoke a program when necessary.
  3199.                This program has to temporarily take over serial I/O
  3200.                processing. Special facilities are available to pass
  3201.                parameters such as the name of the device driver `term'
  3202.                uses to the program. For more information on how to use
  3203.                external programs see Data transfer via external program.
  3204.  
  3205.          `Name'
  3206.                This text entry field either holds the name of the XPR
  3207.                library to use or the name of the external program.
  3208.                Clicking on the select button at the right hand side of
  3209.                the text entry field will bring up either a file
  3210.                requester or another control panel to select the program
  3211.                name and to edit the program parameters.
  3212.  
  3213.          `Send signature'
  3214.                Many file transfer protocols transmit characteristic
  3215.                data to the remote at the beginning of a transmission.
  3216.                This data is called a signature and when found in the
  3217.                incoming data stream `term' will automatically invoke
  3218.                the protocol in question. This is particularly useful
  3219.                with external programs. This text entry field holds the
  3220.                signature which will when received start an upload using
  3221.                the current default protocol.  For more information on
  3222.                protocol signatures see Protocol signatures.
  3223.  
  3224.          `Receive signature'
  3225.                This text entry field holds the signature which will when
  3226.                received start a download using the current default
  3227.                protocol.  For more information on protocol signatures
  3228.                see Protocol signatures.
  3229.  
  3230.          `Edit settings...'
  3231.                Press this button to edit the settings of an XPR
  3232.                library. For an example of how these settings can look
  3233.                like, see XPR options sample.
  3234.  
  3235.     `ASCII transfer'
  3236.           This is where you set up the transfer protocol that is invoked
  3237.           when you select the `Upload ASCII file(s)' and `Download
  3238.           ASCII file(s)' menu items.
  3239.  
  3240.          `Type'
  3241.                You can either select `XPR library', `External program',
  3242.                `<< Default >>' or `Internal' here.
  3243.  
  3244.                `XPR library' will use an external transfer protocol
  3245.                library, such as `xprzmodem.library'. This library will
  3246.                be kept open all the time and may for example handle
  3247.                download session automatically.  For more information on
  3248.                how to use XPR libraries see Data transfer via XPR
  3249.                library.
  3250.  
  3251.                `External program' will invoke a program when necessary.
  3252.                This program has to temporarily take over serial I/O
  3253.                processing. Special facilities are available to pass
  3254.                parameters such as the name of the device driver `term'
  3255.                uses to the program. For more information on how to use
  3256.                external programs see Data transfer via external program.
  3257.  
  3258.                `<< Default >>' will use the default file transfer
  3259.                protocol.
  3260.  
  3261.                `Internal' will use the built-in ASCII transfer
  3262.                protocol. For more information see ASCII-transfer
  3263.                settings.
  3264.  
  3265.          `Send'
  3266.                This text entry field either holds the name of the XPR
  3267.                library to use or the name of the external program for
  3268.                sending ASCII data. Clicking on the select button at the
  3269.                right hand side of the text entry field will bring up
  3270.                either a file requester or another control panel to
  3271.                select the program name and to edit the program
  3272.                parameters.
  3273.  
  3274.          `Receive'
  3275.                This text entry field either holds the name of the XPR
  3276.                library to use or the name of the external program for
  3277.                receiving ASCII data.
  3278.  
  3279.          `Signature'
  3280.                Many file transfer protocols transmit characteristic
  3281.                data to the remote at the beginning of a transmission.
  3282.                This data is called a signature and when found in the
  3283.                incoming data stream `term' will automatically invoke
  3284.                the protocol in question. This is particularly useful
  3285.                with external programs. This text entry field holds the
  3286.                signature which will when received start a transfer
  3287.                using the current ASCII transfer protocol.  For more
  3288.                information on protocol signatures see Protocol
  3289.                signatures.
  3290.  
  3291.          `Edit settings...'
  3292.                Press this button to edit the settings of an XPR
  3293.                library. For an example of how these settings can look
  3294.                like, see XPR options sample.
  3295.  
  3296.     `Text transfer'
  3297.           This is where you set up the transfer protocol that is invoked
  3298.           when you select the `Upload text file(s)', `Edit & upload
  3299.           text file' and `Download text file(s)' menu items.
  3300.  
  3301.          `Type'
  3302.                You can either select `XPR library', `External program'
  3303.                or `<< Default >>' here.
  3304.  
  3305.                `XPR library' will use an external transfer protocol
  3306.                library, such as `xprzmodem.library'. This library will
  3307.                be kept open all the time and may for example handle
  3308.                download session automatically.  For more information on
  3309.                how to use XPR libraries see Data transfer via XPR
  3310.                library.
  3311.  
  3312.                `External program' will invoke a program when necessary.
  3313.                This program has to temporarily take over serial I/O
  3314.                processing. Special facilities are available to pass
  3315.                parameters such as the name of the device driver `term'
  3316.                uses to the program. For more information on how to use
  3317.                external programs see Data transfer via external program.
  3318.  
  3319.                `<< Default >>' will use the default file transfer
  3320.                protocol.
  3321.  
  3322.          `Send'
  3323.                This text entry field either holds the name of the XPR
  3324.                library to use or the name of the external program for
  3325.                sending textual data. Clicking on the select button at
  3326.                the right hand side of the text entry field will bring
  3327.                up either a file requester or another control panel to
  3328.                select the program name and to edit the program
  3329.                parameters.
  3330.  
  3331.          `Receive'
  3332.                This text entry field either holds the name of the XPR
  3333.                library to use or the name of the external program for
  3334.                receiving textual data.
  3335.  
  3336.          `Signature'
  3337.                Many file transfer protocols transmit characteristic
  3338.                data to the remote at the beginning of a transmission.
  3339.                This data is called a signature and when found in the
  3340.                incoming data stream `term' will automatically invoke
  3341.                the protocol in question. This is particularly useful
  3342.                with external programs. This text entry field holds the
  3343.                signature which will when received start a transfer
  3344.                using the current text transfer protocol.  For more
  3345.                information on protocol signatures see Protocol
  3346.                signatures.
  3347.  
  3348.          `Edit settings...'
  3349.                Press this button to edit the settings of an XPR
  3350.                library. For an example of how these settings can look
  3351.                like, see XPR options sample.
  3352.  
  3353.     `Binary transfer'
  3354.           This is where you set up the transfer protocol that is invoked
  3355.           when you select the `Upload binary file(s)' and `Download
  3356.           binary file(s)' menu items.
  3357.  
  3358.          `Type'
  3359.                You can either select `XPR library', `External program'
  3360.                or `<< Default >>' here.
  3361.  
  3362.                `XPR library' will use an external transfer protocol
  3363.                library, such as `xprzmodem.library'. This library will
  3364.                be kept open all the time and may for example handle
  3365.                download session automatically.  For more information on
  3366.                how to use XPR libraries see Data transfer via XPR
  3367.                library.
  3368.  
  3369.                `External program' will invoke a program when necessary.
  3370.                This program has to temporarily take over serial I/O
  3371.                processing. Special facilities are available to pass
  3372.                parameters such as the name of the device driver `term'
  3373.                uses to the program. For more information on how to use
  3374.                external programs see Data transfer via external program.
  3375.  
  3376.                `<< Default >>' will use the default file transfer
  3377.                protocol.
  3378.  
  3379.          `Send'
  3380.                This text entry field either holds the name of the XPR
  3381.                library to use or the name of the external program for
  3382.                sending binary data. Clicking on the select button at
  3383.                the right hand side of the text entry field will bring
  3384.                up either a file requester or another control panel to
  3385.                select the program name and to edit the program
  3386.                parameters.
  3387.  
  3388.                For your convenience, `term' will by default place the
  3389.                standard invocation command for the Hydra protocol here.
  3390.  
  3391.          `Receive'
  3392.                This text entry field either holds the name of the XPR
  3393.                library to use or the name of the external program for
  3394.                receiving binary data.
  3395.  
  3396.                For your convenience, `term' will by default place the
  3397.                standard invocation command for the Hydra protocol here.
  3398.  
  3399.          `Signature'
  3400.                Many file transfer protocols transmit characteristic
  3401.                data to the remote at the beginning of a transmission.
  3402.                This data is called a signature and when found in the
  3403.                incoming data stream `term' will automatically invoke
  3404.                the protocol in question. This is particularly useful
  3405.                with external programs. This text entry field holds the
  3406.                signature which will when received start a transfer
  3407.                using the current binary transfer protocol.  For more
  3408.                information on protocol signatures see Protocol
  3409.                signatures.
  3410.  
  3411.          `Edit settings...'
  3412.                Press this button to edit the settings of an XPR
  3413.                library. For an example of how these settings can look
  3414.                like, see XPR options sample.
  3415.  
  3416. `Use'
  3417.      Use the current settings.
  3418.  
  3419. `Default (phonebook only)'
  3420.      Drop the current settings, making a connection to the corresponding
  3421.      phone number will leave the corresponding main configuration entry
  3422.      unchanged.
  3423.  
  3424. `Cancel'
  3425.      Keep the old settings.
  3426.  
  3427.    Settings for each transfer library are saved in text files in the
  3428. `ENVARC:' and `ENV:' drawers.
  3429.  
  3430.    Leave the default transfer library set to the one you intend to use
  3431. most.
  3432.  
  3433. XPR options sample
  3434. ==================
  3435.  
  3436.    You will find an excerpt of the `xprzmodem.doc' documentation file
  3437. for the ZModem file transfer protocol below which is the default
  3438. transfer protocol `term' is shipped with. Please note that other file
  3439. transfer protocols will sport different options and controls, you
  3440. should consult the corresponding documentation for more information.
  3441.  
  3442. `Text translation mode:'
  3443.     `Y = Text Yes'
  3444.           If receiving, translate CR/LF pairs or solo CR chars to
  3445.           normal Amiga LF chars.  Ignore data past ^Z. If sending,
  3446.           suggests to receiver that they should receive this file in
  3447.           text mode.
  3448.  
  3449.     `N = Text No'
  3450.           Receive file verbatim, without changes.  If sending, suggest
  3451.           to receiver that they receive this file verbatim, without
  3452.           translations.
  3453.  
  3454.     `? = Text status unknown'
  3455.           If receiving, use sender's suggestion as to whether to do end
  3456.           of line translations or not. If sending, tell receiver to use
  3457.           default mode, since we don't know either.
  3458.  
  3459.     `C = Text mode set by Comm program'
  3460.           The library asks the communications program whether or not to
  3461.           use Text mode for each file. If the communications program
  3462.           does not support the necessary `xpr_finfo()' call, or if the
  3463.           call fails, this option acts like T?.  From the user's point
  3464.           of view, what this option normally does is set the Text mode
  3465.           to match the communications program's built-in
  3466.           text/binary/end-of-line/translation mode, if any.
  3467.  
  3468. `Overwrite mode:'
  3469.     `Y = Overwrite Yes'
  3470.           If about to receive file with same name as one which already
  3471.           exists, delete the old file and receive the new file in its
  3472.           place.
  3473.  
  3474.     `N = Overwrite No'
  3475.           If about to receive file with same name as one which already
  3476.           exists, append ".dup" onto the name of the new file to keep
  3477.           them separate.
  3478.  
  3479.     `R = Overwrite Resume'
  3480.           If about to receive file with same name as one which already
  3481.           exists, resume receiving file data from the current end of
  3482.           the existing file.
  3483.  
  3484.     `S = Overwrite Skip'
  3485.           If about to receive file with same name as one which already
  3486.           exists, skip this file, we don't want it.  Batch transfers
  3487.           will move on to the next file in the set, if any.
  3488.  
  3489. `Buffer size:'
  3490.      `xprzmodem.library' adds a layer of file I/O buffering in addition
  3491.      to whatever the comm program may or may not provide.  This option
  3492.      sets the size of XPRZModem's file I/O buffer in kilobytes.  The
  3493.      minimum value is 1 KB, for those using RAM drives or fast hard
  3494.      drives, or those whose comm programs already provide sufficient
  3495.      buffering.  The maximum value is as much contiguous RAM as you
  3496.      have available in your Amiga.  If you specify more than is
  3497.      actually available, XPRZModem will keep decrementing the buffer
  3498.      size requested by 1 KB until the memory allocation works.  That
  3499.      way, if your RAM is too fragmented to use the amount you request,
  3500.      XPRZModem simply uses the largest block available.  Buffering is
  3501.      especially helpful for floppy drive users; it keeps your drive from
  3502.      continuously gronking and slowing things down all through the
  3503.      transfer.
  3504.  
  3505.      *Additional note for `term' users: this option is practically
  3506.      replaced by the `I/O buffer size' settings in the miscellaneous
  3507.      panel (see Miscellaneous panel).*
  3508.  
  3509. `Frame size:'
  3510.      Although normally avoided, ZModem has the ability to require an
  3511.      ACK to be sent from the receiver to the sender every X-many data
  3512.      bytes.  Normally you don't want to use this feature, because not
  3513.      waiting for ACKs is part of how ZModem works so fast.  However,
  3514.      this feature can be very useful in conjunction with file I/O
  3515.      buffering on slow devices (namely those floppy drives).  If you
  3516.      set up a large I/O buffer to avoid gronking your floppy so often,
  3517.      you'll find that when the buffer finally *does* get around to
  3518.      being flushed that it can take a looonng time; so long, in fact,
  3519.      that the delay can cause timeouts and errors.  But if you set your
  3520.      ZModem to require the sender to wait for an ACK every
  3521.      buffer's-worth of data, the sender will politely wait for you to
  3522.      flush your buffer to the slow floppy and send it an ACK saying
  3523.      it's OK to continue now.  This value should be set to 0 to disable
  3524.      ACKs (normal mode), or set it to the actual number of data bytes
  3525.      allowed between ACKs.  For example, if you set the Buffer size to
  3526.      64KB because of your floppy, you should also set the Frame size to
  3527.      65536 bytes.
  3528.  
  3529. `Error limit:'
  3530.      This allows you to set the number of sequential errors which will
  3531.      be required to convince ZModem to abort the transfer.  The normal
  3532.      value is 10, meaning that 10 errors must happen in a row with no
  3533.      valid data being transferred in order to cause an abort.  This
  3534.      setting is provided for those using XPRZModem with a BBS, who may
  3535.      wish to use a relaxed setting, or those with really lousy phone
  3536.      lines who are desperate and patient enough to want the transfer to
  3537.      continue in spite of horrible performance.
  3538.  
  3539. `Auto-activate mode:'
  3540.     `Y = Auto-activate Yes'
  3541.           If the comm program supports the ability, the library will
  3542.           automatically go into receive mode when the start of a ZModem
  3543.           download is detected.
  3544.  
  3545.     `N = Auto-activate No'
  3546.           Don't try to automatically start downloading, make the user
  3547.           activate it.
  3548.  
  3549. `Delete after sending:'
  3550.     `Y = Delete Yes'
  3551.           Delete each file after it has been Successfully sent.
  3552.  
  3553.     `N = Delete No'
  3554.           Don't delete files after sending them.
  3555.  
  3556. `Keep partial files:'
  3557.     `Y = Keep Yes'
  3558.           Keep the fragment of a file received so far if file reception
  3559.           is aborted.  This allows you to use the Overwrite Resume
  3560.           option above to pick up where you left off on your next
  3561.           attempt.
  3562.  
  3563.     `N = Keep No'
  3564.           Delete any partially-received file after an aborted transfer.
  3565.  
  3566. `Send full directory path:'
  3567.     `Send path Yes'
  3568.           Send full filenames including drawer path to receiver.
  3569.  
  3570.     `Send path No'
  3571.           Send only simple filenames, not including drawer path.
  3572.  
  3573. `Default received path:'
  3574.      Store all received files in this drawer, if option "Use received
  3575.      path" is not checked.  Ignored entry if option `Use received path'
  3576.      is checked.  The path can be any valid existing drawer, with or
  3577.      without trailing `/' (e.g. `df0:', `Comm:hold', etc.).
  3578.  
  3579.      *Additional note for `term' users: the default received path option
  3580.      is ignored if the `Override transfer path' switch in the
  3581.      miscellaneous panel (see Miscellaneous panel) is enabled.*
  3582.  
  3583.    You will also find the familiar `Use' and `Cancel' buttons here which
  3584. will either keep or discard the changes you made to the settings.
  3585.  
  3586. Translation panel
  3587. =================
  3588.  
  3589.    `term' is capable of replacing any incoming and outgoing character
  3590. with custom text. This may come in handy with the numerous incarnations
  3591. of the dreaded IBM PC font. The control panel to be opened features a
  3592. large list of buttons, each single one representing a single character.
  3593. Some characters are shown with their corresponding glyphs, some with
  3594. their symbolic names and some as plain numbers. Clicking on one of the
  3595. buttons will bring up a control panel which allows setting the text to
  3596. be received by the terminal emulation when a certain character is
  3597. received and the text to be sent when a certain characters is
  3598. transmitted. Alternatively, you can press the key combination
  3599. corresponding to the character whose translation you wish to change.
  3600.  
  3601.    Both receive and send translation texts can consist of standard
  3602. command sequences (see Command sequences), except for the following
  3603. commands which are not supported:  `\a', `\c', `\d', `\g', `\i', `\p',
  3604. `\u' and `\x'.
  3605.  
  3606.    Please note that the translation does not come for free, terminal
  3607. input and output speed may suffer.
  3608.  
  3609.    As of this writing only a few translation table files (see below) are
  3610. included in the distribution. If you wish to create translation tables
  3611. for IBM doorway mode, national IBM PC style font variants, etc. feel
  3612. free to send them to me. I will try to include them in the next `term'
  3613. release.
  3614.  
  3615.    Currently included in the `term' distribution are the following
  3616. translation table files:
  3617.  
  3618. `ISO-4-(GB).prefs'
  3619.      British 7 bit (ISO code 4) character set.
  3620.  
  3621. `ISO-10-(S).prefs'
  3622.      Swedish 7 bit (ISO code 10) character set.
  3623.  
  3624. `ISO-11-(S).prefs'
  3625.      Swedish 7 bit (ISO code 11) character set.
  3626.  
  3627. `ISO-15-(I).prefs'
  3628.      Italian 7 bit (ISO code 15) character set.
  3629.  
  3630. `ISO-16-(P).prefs'
  3631.      Portuguese 7 bit (ISO code 16) character set.
  3632.  
  3633. `ISO-17-(E).prefs'
  3634.      Spanish 7 bit (ISO code 17) character set.
  3635.  
  3636. `ISO-21-(D).prefs'
  3637.      German 7 bit (ISO code 21) character set.
  3638.  
  3639. `ISO-60-(N).prefs'
  3640.      Norwegian 7 bit (ISO code 60) character set.
  3641.  
  3642. `ISO-61-(N).prefs'
  3643.      Norwegian 7 bit (ISO code 61) character set.
  3644.  
  3645. `ISO-69-(F).prefs'
  3646.      French 7 bit (ISO code 69) character set.
  3647.  
  3648. `PC-8.prefs'
  3649.      Character translation for standard IBM PC style font. If you wish
  3650.      to use these translation tables, make sure to set the `Font' type
  3651.      in the terminal panel (see Terminal panel) to `IBM PC style (raw)'.
  3652.  
  3653.    Unfortunately, there is no translation available for the Norwegian
  3654. and Danish variants of the PC-8 character set as I do not yet have a
  3655. fitting Amiga font available. Similar reasons have yet prevented to
  3656. implement PC-850 character set support.
  3657.  
  3658. Function key panel
  3659. ==================
  3660.  
  3661.    This control panel allows setting user definable texts for all ten
  3662. function keys. All texts are considered command sequences (see Command
  3663. sequences), a topic which will be covered later in this document.
  3664.  
  3665. `Modifier'
  3666.      All in all 40 keys may be covered with user defined command
  3667.      sequences (Command sequences). As the Amiga keyboard only has ten
  3668.      function-keys this button switches between the modifier keys
  3669.      (`Shift', `Control', `Alt') which, if pressed in addition which a
  3670.      function key, will execute one of the 40 command sequences.
  3671.  
  3672. `Load'
  3673.      Load the function key settings from a file.
  3674.  
  3675. `Save'
  3676.      Save the function key settings to a file.
  3677.  
  3678. `Use'
  3679. `Close'
  3680.      Closes the window, but keeps the settings.
  3681.  
  3682.    As the definition of the function keys with command sequences
  3683. contradicts the standard definition of the four functions keys of a
  3684. VT100 terminal, the keys `F1'-`F4', which may be executed by pressing
  3685. the `Shift' key and the approriate function-key simultaneously, are
  3686. mapped to the standard sequences for function-keys.  The user may - of
  3687. course - change these settings.
  3688.  
  3689.    If an external terminal emulation happens to be active, those
  3690. function keys the emulation has allocated for itself will be disabled
  3691. and cannot be edited.
  3692.  
  3693.    The traditional VT100 PF-keys (programmable function keys) are
  3694. mapped to the top row of the numeric keypad. Hold down the `Control'
  3695. key and press a top row key to produce the corresponding PF key code.
  3696.  
  3697. Cursor key panel
  3698. ****************
  3699.  
  3700.    This control panel both works and looks similar to the function key
  3701. panel (see Function key panel), the only difference is that it is to
  3702. assign command sequences to the cursor keys rather than to the function
  3703. keys. Displayed are the assignments for all four cursor keys and the
  3704. following buttons:
  3705.  
  3706. `Modifier'
  3707.      Any cursor key can be pressed along with one of the modifier keys
  3708.      (`Shift', `Control', `Alt'). This button will switch between the
  3709.      different assignments.
  3710.  
  3711. `Load'
  3712.      Load the cursor key settings from a file.
  3713.  
  3714. `Save'
  3715.      Save the cursor key settings to a file.
  3716.  
  3717. `Use'
  3718.      Use the current settings.
  3719.  
  3720. `Cancel'
  3721.      Keep the old settings.
  3722.  
  3723. Fast macro panel
  3724. ================
  3725.  
  3726.    The design and implementation of the settings to be configured in
  3727. this menu are closely related to the menu entry function key panel (see
  3728. Function key panel) discussed before. The only difference to be seen in
  3729. the fact that the fast! macros are mapped to buttons rather than
  3730. function keys (more on this topic later in this document, see Fast!
  3731. macros).
  3732.  
  3733. `Macro list'
  3734.      The list of macros entered yet, to edit one of these, select it by
  3735.      clicking the mouse button with the mouse pointer on it.
  3736.  
  3737. `Macro'
  3738.      The name of a macro by which it is listed in the fast! macro list.
  3739.  
  3740. `Macro text'
  3741.      The command sequence (see Command sequences) associated with a
  3742.      fast! macro. Command sequences are discussed later in this
  3743.      document.
  3744.  
  3745. `New'
  3746.      Appends a new macro to the list. The user may then select and
  3747.      customize it.
  3748.  
  3749. `Remove'
  3750.      Removes the currently selected macro from the list.
  3751.  
  3752. `Clear'
  3753.      Removes all the macros from list, clearing it.
  3754.  
  3755. `Load'
  3756.      Loads the macro list from a file.
  3757.  
  3758. `Save'
  3759.      Saves the macro list to a file.
  3760.  
  3761. `Close'
  3762.      Closes the window, but keeps the settings.
  3763.  
  3764. `|<'
  3765.      Places the currently selected macro at the top of the list.
  3766.  
  3767. `<'
  3768.      Moves the currently selected macro one entry up.
  3769.  
  3770. `>'
  3771.      Moves the currently selected macro one entry down.
  3772.  
  3773. `>|'
  3774.      Places the currently selected macro at the end of the list.
  3775.  
  3776. Hotkey panel
  3777. ============
  3778.  
  3779.    This is where the key sequences used to arrange screens and to
  3780. execute special functions are to be configured.
  3781.  
  3782. `term screen to front'
  3783.      The keys to press to bring the `term' screen to the front.
  3784.  
  3785. `Buffer screen to front'
  3786.      The keys to press to bring the screen of the text buffer to the
  3787.      front.
  3788.  
  3789. `Skip dial entry'
  3790.      As an alternative to the `Skip' button, pressing these keys will
  3791.      skip a dialing entry if the dialing function is currently active.
  3792.  
  3793. `Stop ARexx command'
  3794.      An ARexx script started from within `term' can be aborted by
  3795.      pressing these keys. Use this function only if pressing `Control +
  3796.      C' does not stop the program execution.
  3797.  
  3798. `Commodity priority'
  3799.      The commodity priority to assign this task to. You may want to
  3800.      change this value if you have more than one program running which
  3801.      uses the same key sequences as `term'. The program with the higher
  3802.      commodity priority will receive the keystrokes first.
  3803.  
  3804. `Hotkeys enabled'
  3805.      Whether the hotkeys are enabled or not can be toggled by clicking
  3806.      on this button, or by using the `Exchange' program to be found in
  3807.      the `Tools/Commodities' drawer.
  3808.  
  3809. `Load'
  3810.      Loads the hotkey settings from a file.
  3811.  
  3812. `Save'
  3813.      Saves the hotkey settings to a file.
  3814.  
  3815. `Use'
  3816.      Use the current settings.
  3817.  
  3818. `Cancel'
  3819.      Keep the original settings.
  3820.  
  3821.    `term' will refuse to accept invalid keyword combinations. You will
  3822. be notified by a brief screen flash/bell signal and the cursor will
  3823. reappear in the text entry field whose contents are rejected.
  3824.  
  3825. Speech panel
  3826. ============
  3827.  
  3828.    If enabled, the Amiga speech synthesizer will be used to alert the
  3829. user of certain actions, such as carrier lost, connection made, etc.
  3830. This feature makes sense if `term' is running in the background where
  3831. the user cannot see what is actually happening on the main screen. By
  3832. default this feature is disabled.
  3833.  
  3834.    *Note: speech synthesis is no longer available since Workbench v2.1
  3835. was introduced!*
  3836.  
  3837. `Rate (words/minute)'
  3838.      Speaking speed in words per minute.
  3839.  
  3840. `Pitch (Hz)'
  3841.      The greater this value, the higher the voice appears to be
  3842.      speaking.
  3843.  
  3844. `Frequency (Hz)'
  3845.      Voice frequency in Hertz.
  3846.  
  3847. `Volume'
  3848.      The volume of the voice in percent.
  3849.  
  3850. `Sex'
  3851.      Enabled female or male voice.
  3852.  
  3853. `Speech enabled'
  3854.      Toggles the activity of the speech synthesizer.
  3855.  
  3856. `Speak!'
  3857.      Speaks a small sample text, note that speech must be enabled for
  3858.      this function to work.
  3859.  
  3860. `Load'
  3861.      Loads the speech settings from a file.
  3862.  
  3863. `Save'
  3864.      Saves the speech settings to a file.
  3865.  
  3866. `Use'
  3867.      Use the current settings.
  3868.  
  3869. `Cancel'
  3870.      Keep the original settings.
  3871.  
  3872. Sound panel
  3873. ===========
  3874.  
  3875.    As an option `term' will associate sounds with special program
  3876. functions and events. This is where the sounds are configured:
  3877.  
  3878. `Terminal bell sound'
  3879.      The sound to be played whenever a `BEL' character is output on the
  3880.      terminal screen.
  3881.  
  3882. ``Connect' sound'
  3883.      The sound to be played when a connection is established.
  3884.  
  3885. ``Disconnect' sound'
  3886.      The sound to be played when a connection is lost.
  3887.  
  3888. ``File transfer finished' sound'
  3889.      The sound to be played when a file transfer is finished
  3890.      successfully.
  3891.  
  3892. ``File transfer failed' sound'
  3893.      The sound to be played when a file transfer is finished
  3894.      unsuccessfully.
  3895.  
  3896. `Modem `ring' sound'
  3897.      The sound to be played when the modem detects a call by a
  3898.      different modem.
  3899.  
  3900. `Modem `voice' sound'
  3901.      The sound to be played when the modem detects a phone call.
  3902.  
  3903. `Error sound'
  3904.      The sound to be played when a number of file transfer errors have
  3905.      occured (see Transfer panel).
  3906.  
  3907. `Volume'
  3908.      This slider affects the volume of all sounds produced by `term'.
  3909.      Setting it to zero suppresses sound output.
  3910.  
  3911. `Preload sound files'
  3912.      If this switch is enabled `term' will load all sound files
  3913.      immediately rather than accessing and loading them on demand. This
  3914.      may save access time when a sound is to be played but may eat up
  3915.      precious memory.
  3916.  
  3917. `Load'
  3918.      Load the sound settings from a file.
  3919.  
  3920. `Save'
  3921.      Save the sound settings to a file.
  3922.  
  3923. `Use'
  3924.      Use the current settings.
  3925.  
  3926. `Cancel'
  3927.      Keep the old settings.
  3928.  
  3929.    There is no fixed size limit to sound files, the amount of available
  3930. system memory matters. The sound files may be compressed, mono or
  3931. stereo files.
  3932.  
  3933.    As of Workbench 2.04 `term' will only load plain IFF-8SVX format
  3934. sound files. With Workbench 3.x any sound file can be loaded for which
  3935. there exists a datatypes class. Please note that due to an operating
  3936. system bug sound files larger than 102,400 bytes will not play
  3937. correctly under Workbench 3.0.
  3938.  
  3939. Transfer progress panel
  3940. =======================
  3941.  
  3942.    The transfer routines open an information window in which a number of
  3943. transfer parameters are displayed. Additionally, the file transfer can
  3944. be aborted by clicking either of the three buttons (`Stop entire
  3945. transfer', `Skip current file' or `Stop transfer batch').  *For most
  3946. transfer protocols all buttons have the same effect.* Consult the
  3947. documentation to see if different levels of abort are supported by your
  3948. favourite transfer protocol.
  3949.  
  3950.    The following information is displayed in the transfer window:
  3951.  
  3952. `Protocol'
  3953.      The name of the transfer protocol currently running.
  3954.  
  3955. `Information'
  3956.      A list to contain error message, the names files transferred and
  3957.      miscellaneous other messages addressed to the user. Error messages
  3958.      are printed in a special colour.
  3959.  
  3960. `File'
  3961.      The name of the file being transferred.
  3962.  
  3963. `Next file'
  3964.      The name of the next file to be sent.
  3965.  
  3966. `Space left'
  3967.      The space left on the destination device. `term' will try to
  3968.      calculate the number of blocks the file being received will take
  3969.      on the destination device and display a warning the file in
  3970.      question is probably not going to fit.
  3971.  
  3972.      *Caution: `term' only makes a very likely guess which may or may
  3973.      not come true. The guess may be wrong if the destination device
  3974.      happens to be a kind of Ram-Disk which shrinks and expands as
  3975.      memory requirements come and go. Such devices are usually 100%
  3976.      full. In most other cases you will probably be able to make room
  3977.      for the file being received before any space problem turns up.*
  3978.  
  3979. `Completion time'
  3980.      If the corresponding information is available, the point of time
  3981.      when the current file will be transferred completely.
  3982.  
  3983. `File size'
  3984.      If available, the size of the file.
  3985.  
  3986. `Bytes xfered'
  3987.      Number of bytes transferred yet.
  3988.  
  3989. `Total size'
  3990.      The total size of all files to be transferred.
  3991.  
  3992. `Total bytes xfered'
  3993.      The total number of bytes transferred yet.
  3994.  
  3995. `Files xfered'
  3996.      The number of files transferred yet and the number of files to go.
  3997.  
  3998. `Blocks xfered'
  3999.      Number of data blocks transferred yet.
  4000.  
  4001. `Characters/second'
  4002.      The effective transfer speed in characters per second.
  4003.  
  4004. `Character delay'
  4005.      The delay between two character being sent.
  4006.  
  4007. `Packet delay'
  4008.      The delay between two packets being sent.
  4009.  
  4010. `Packet type'
  4011.      A short description of the data block type employed for data
  4012.      transfer.
  4013.  
  4014. `Block check type'
  4015.      The method employed to verify the integrity of the data blocks
  4016.      being transferred (this usually is a form of cyclic redundancy
  4017.      checking).
  4018.  
  4019. `Block size'
  4020.      Size of a data block in bytes.
  4021.  
  4022. `Expected time'
  4023.      The time the transfer protocol expects the transfer will take.
  4024.  
  4025. `Elapsed time'
  4026.      The time elapsed during transfer.
  4027.  
  4028. `Number of errors'
  4029.      The number of errors occured during file transfer.
  4030.  
  4031. `Number of timeouts'
  4032.      The number of timeouts occured during file transfer.
  4033.  
  4034.    If the currently active transfer protocol provides the necessary
  4035. information, two bars will be displayed at the bottom of the transfer
  4036. window indicating the amount of transferred data and of time to go
  4037. before the transfer is finished.
  4038.  
  4039.    `term' knows about the Z-Modem data-inquiry sequence the remote
  4040. receiver issues when expecting files. If recognized, this sequence will
  4041. cause `term' to display a requester asking for the type of data upload:
  4042. text or binary. One could call this feature `auto upload'. You also have
  4043. the opportunity to select `Abort' which will transfer the ZModem abort
  4044. sequence or to click on the `Ignore' gadget which will plainly ignore
  4045. the fact that the ZModem inquiry sequence has been recognized.  *The
  4046. Z-Modem abort sequence will also be transferred if you select the
  4047. `Cancel' button in the file requester to appear after selecting text-
  4048. or binary-upload.* If the `Upload from queue' option is in effect the
  4049. contents of the transfer queue will be uploaded.
  4050.  
  4051.    *Some transfer protocols will allow you to enter a default receive
  4052. path the library is supposed to create files it receives in. On request
  4053. (see Miscellaneous panel) `term' will ignore these settings and use the
  4054. settings to be changed in the `Settings/Paths' (see Path panel) menu
  4055. instead.*
  4056.  
  4057.    Each file that is received and which does not remain empty is
  4058. examined briefly to find out about the file type. If recognized
  4059. successfully and the corresponding feature is enabled, a small comment
  4060. indicating the file type will be attached to the file. `term' currently
  4061. knows about 83 different file types.
  4062.  
  4063.    If the `term' main window is opened on the Workbench screen, you can
  4064. select and drag icons on it in order to upload the corresponding files.
  4065. A requester will be opened to ask for the upload style (either binary or
  4066. text).
  4067.  
  4068.    In case a file transfer terminates with an unrecoverable error
  4069. (*note:  the transfer protocol is responsible for reporting error
  4070. conditions to `term'*) the file transfer window will stay open until
  4071. explicitly closed by the user so the transfer error report list can be
  4072. viewed.
  4073.  
  4074. ASCII-transfer panel
  4075. ====================
  4076.  
  4077.    The built-in ASCII transfer routines as to be enabled in the
  4078. transfer panel (see Transfer panel) display transfer progress
  4079. information in a special window (note that sending and receiving will
  4080. open different windows). Here is a description of the controls and
  4081. displays:
  4082.  
  4083. `Bytes xfered'
  4084.      The number of bytes sent/received.
  4085.  
  4086. `Lines xfered'
  4087.      The number of text lines sent/received.
  4088.  
  4089. `Information'
  4090.      Transfer progress information and error display.
  4091.  
  4092. `Character delay'
  4093.      When sending text this number determines how many seconds to wait
  4094.      before sending the next character.
  4095.  
  4096. `Line delay'
  4097.      When sending text this number determines how many seconds to wait
  4098.      before sending the line-termination character (carriage return).
  4099.  
  4100. `Text pacing'
  4101.      The mode to determine how text is sent to the remote:
  4102.  
  4103.     `Direct'
  4104.           Each line will be sent without any delay.
  4105.  
  4106.     `Wait for echo'
  4107.           The program will wait for each single character sent to be
  4108.           echoed by the remote.
  4109.  
  4110.     `Wait for any echo'
  4111.           The program will wait for the remote to return any character
  4112.           in response to any character sent. Typically, this is the case
  4113.           with password prompts issued by BBSes.
  4114.  
  4115.     `Wait for line prompt'
  4116.           The program will wait until the remote sends a certain line
  4117.           prompt text.
  4118.  
  4119.     `Character/line delay'
  4120.           The program will respect the character/line delay values to
  4121.           be set using this control panel.
  4122.  
  4123.     `Keyboard delay'
  4124.           The program will send character separated by a delay to be
  4125.           determined by the current system keyboard repeat delay.
  4126.  
  4127.      *Note: the `echo' text pacing modes are to be used with greate
  4128.      care. Certain online services do not echo characters back to the
  4129.      sender as they run only in half-duplex mode.  On the other hand
  4130.      most mailbox programs will not echo certain characters, such as
  4131.      escape codes, etc.*
  4132.  
  4133. `Quiet transfer'
  4134.      This switch controls whether incoming text will be displayed in the
  4135.      terminal window. You may want to watch how the remote responds to
  4136.      the data sent/received.
  4137.  
  4138. `Skip current file'
  4139.      Stops sending the current file and proceeds to the next.
  4140.  
  4141. `Stop entire transfer'
  4142.      Stops the ASCII data transfer.
  4143.  
  4144.    In case a file transfer terminates with an unrecoverable error the
  4145. file transfer window will stay open until explicitly closed by the user
  4146. so the transfer error report list can be viewed.
  4147.  
  4148. ASCII-transfer settings
  4149. =======================
  4150.  
  4151. `Text pacing'
  4152.      The mode to determine how text is sent to the remote:
  4153.  
  4154.     `Direct'
  4155.           Each line will be sent without any delay.
  4156.  
  4157.     `Wait for echo'
  4158.           The program will wait for each single character sent to be
  4159.           echoed by the remote.
  4160.  
  4161.     `Wait for any echo'
  4162.           The program will wait for the remote to return any character
  4163.           in response to any character sent. Typically, this is the case
  4164.           with password prompts issued by BBSes.
  4165.  
  4166.     `Wait for line prompt'
  4167.           The program will wait until the remote sends a certain line
  4168.           prompt text.
  4169.  
  4170.     `Character/line delay'
  4171.           The program will respect the character/line delay values to
  4172.           be set using this control panel.
  4173.  
  4174.     `Keyboard delay'
  4175.           The program will send character separated by a delay to be
  4176.           determined by the current system keyboard repeat delay.
  4177.  
  4178.      *Note: the `echo' text pacing modes are to be used with greate
  4179.      care. Certain online services do not echo characters back to the
  4180.      sender as they run only in half-duplex mode.  On the other hand
  4181.      most mailbox programs will not echo certain characters, such as
  4182.      escape codes, etc.*
  4183.  
  4184. `Character delay'
  4185.      When sending text this number determines how many seconds to wait
  4186.      before sending the next character.
  4187.  
  4188. `Line delay'
  4189.      When sending text this number determines how many seconds to wait
  4190.      before sending the line-termination character (carriage return).
  4191.  
  4192. `Line prompt'
  4193.      The character to wait for the receiver to issue after a line of
  4194.      text is send. These character may include command sequence tokens.
  4195.  
  4196. `Send timeout'
  4197.      If the `Text pacing' mode is set to  `Wait for echo' or `Wait for
  4198.      line prompt' the maximum time to wait for echo/prompt before the
  4199.      insertion is aborted.
  4200.  
  4201. `Send CR'
  4202. `Send LF'
  4203.      These buttons determine the sequences that are sent to the remote
  4204.      if a carriage return (CR) or line feed (LF) character is to be
  4205.      transmitted.  Both characters serve as end-of-line indicators.
  4206.  
  4207.     `-'
  4208.           The character is suppressed.
  4209.  
  4210.     `<<CR>>'
  4211.           A carriage return character is sent.
  4212.  
  4213.     `<<LF>>'
  4214.           A line feed character is sent.
  4215.  
  4216.     `<<CR>><<LF>>'
  4217.           A sequence of two characters (carriage return followed by
  4218.           line feed) is sent.
  4219.  
  4220.     `<<LF>><<CR>>'
  4221.           A sequence of two characters (line feed followed by carriage
  4222.           return) is sent.
  4223.  
  4224. `Receive CR'
  4225. `Receive LF'
  4226.      These two buttons have largely the same effect as the `Send CR/LF'
  4227.      buttons, they are different in that they affect the incoming data
  4228.      rather than the data transmitted.
  4229.  
  4230. `Ignore data past terminator'
  4231.      With this option enabled the receiver will search for a
  4232.      termination character in the incoming data stream. If this
  4233.      character is found the transfer will be terminated.
  4234.  
  4235. `Terminator character'
  4236.      Enter the ASCII code of the terminator character to be used for
  4237.      the `Ignore data past terminator' feature here.
  4238.  
  4239. `Quiet ASCII transfer'
  4240.      If this switch is not enabled, the built-in ASCII upload/download
  4241.      routines will display the outgoing/incoming data in the terminal
  4242.      window. This option is to let you watch the progress of the file
  4243.      transfer, so that, for example, if the remote does not respond to
  4244.      the data you send, you may want to stop and restart the upload.
  4245.  
  4246. `Strip bit 8'
  4247.      If this switch is effect each character received or transmitted by
  4248.      `term' will have its high-order bit cleared.
  4249.  
  4250.    With ASCII uploads it is important to make sure that end-of-line
  4251. characters such as carriage return and line feed are properly set up
  4252. for the remote.  While on the Amiga it is common to end a line of text
  4253. with a line feed character, most editors and such expect a carriage
  4254. return character to be transferred. This can easily be arranged by
  4255. setting the `Send LF' switch to `<<CR>>'.
  4256.  
  4257. Phonebook
  4258. =========
  4259.  
  4260.    The functions described in the following can be found in the `Modem'
  4261. menu and relate to the menu entries `Phonebook', `Dial' and `Redial'.
  4262.  
  4263.    `term' is equipped with a telephone number management system, the
  4264. phonebook, which is described in the following lines.
  4265.  
  4266. `Group button'
  4267.      At the top of the window you will find button which displays the
  4268.      name of the group whose contents are displayed below in the list.
  4269.      By default, you will find the name `<< All entries >>' here, which
  4270.      indicates that not a specific group is displayed, but rather all
  4271.      entries the phonebook consists of. You can switch between groups
  4272.      by pressing the `[Tab]' key.
  4273.  
  4274. `List'
  4275.      Below the group button the list of phonebook entries belonging to
  4276.      the group in question are displayed. You can move through the list
  4277.      using the `[Cursor up]' and `[Cursor down]' keys. To tag any
  4278.      entries for dialing, hold down and `[Shift]' key and click on the
  4279.      entries using the mouse, alternatively, highlight the entry, then
  4280.      press the `[Space]' key. To untag them, repeat the procedure again.
  4281.      A double-click on a single entry will tag the entry and
  4282.      immediately start dialing.
  4283.  
  4284. `Comment display'
  4285.      For each entry you highlight its associated comment is displayed
  4286.      in the area below the list.
  4287.  
  4288. `|<'
  4289.      Press this button to move the highlighted phonebook entry to the
  4290.      beginning of the list.
  4291.  
  4292. `<'
  4293.      Press this button to move the highlighted phonebook entry one slot
  4294.      up in the list.
  4295.  
  4296. `>'
  4297.      Press this button to move the highlighted phonebook entry one slot
  4298.      down in the list.
  4299.  
  4300. `>|'
  4301.      Press this button to move the highlighted phonebook entry to the
  4302.      end of the list.
  4303.  
  4304. `All'
  4305.      To tag all entries visible in the list above, press this button.
  4306.  
  4307. `Toggle'
  4308.      This button tags all visible entries that were untagged before the
  4309.      button was pressed and untags all entries that were tagged.
  4310.  
  4311. `None'
  4312.      Press this button to untag all visible entries.
  4313.  
  4314. `Pattern'
  4315.      This button brings up another window to tag/untag entries matching
  4316.      a pattern:
  4317.  
  4318.     `Mode button'
  4319.           This is where you select if you want to untag or tag the
  4320.           entries matching the pattern below. You can press the `[Tab]'
  4321.           button to switch modes.
  4322.  
  4323.     `System name'
  4324.     `Comment'
  4325.     `Numbers'
  4326.           Any phonebook entries whose name matches this name, comment
  4327.           and number patterns will get tagged/untagged.
  4328.  
  4329.     `Apply'
  4330.           Tags/untags phonebook entries matching the pattern. The
  4331.           pattern window will stay open.
  4332.  
  4333.     `Apply+Close'
  4334.           Tags/untags phonebook entries matching the pattern and closes
  4335.           the pattern window.
  4336.  
  4337.     `Close'
  4338.           Closes the pattern window, does not tag/untag phonebook
  4339.           entries.
  4340.  
  4341. `Edit...'
  4342.      Brings up the phonebook entry editor, for more information see
  4343.      Phonebook entry panel.
  4344.  
  4345. `Dial'
  4346.      Merges all tagged entries by the order in which they were tagged
  4347.      into a list and hands it to the dialer.
  4348.  
  4349. `Copy...'
  4350.      Makes a copy of the currently highlighted phonebook entry and
  4351.      brings up the phonebook entry editor, for more information see
  4352.      Phonebook entry panel.
  4353.  
  4354. `Use'
  4355.      Copies the settings associated with the highlighted phonebook
  4356.      entry into the global program settings and closes the phonebook
  4357.      window.
  4358.  
  4359. `Add...'
  4360.      Adds a new phonebook entry and initializes it with default values,
  4361.      then brings up the phonebook entry editor, for more information
  4362.      see Phonebook entry panel.
  4363.  
  4364. `Delete'
  4365.      Removes the highlighted entry from the phonebook.
  4366.  
  4367. `Group'
  4368.      Brings up the group window:
  4369.  
  4370.     `Select group'
  4371.           From this list, pick the group you wish to add the tagged
  4372.           entries or the highlighted entry to.
  4373.  
  4374.     `Or enter group name'
  4375.           Alternatively, you may enter the name of a new group to add
  4376.           the entries to.
  4377.  
  4378.     `Use'
  4379.           If there are entries tagged, they will be added to the group
  4380.           you have specified, the group will be created if it does not
  4381.           yet exist. If no entries are tagged, the highlighted entry
  4382.           will be used instead. The group window will be closed and the
  4383.           group button and list will be updated.
  4384.  
  4385.     `Cancel'
  4386.           The group window will be closed.
  4387.  
  4388. `UnGroup'
  4389.      The currently displayed group will be deleted. This does not delete
  4390.      the entries in the group.
  4391.  
  4392. `Auto dial'
  4393.      This feature corresponds to the switch of the same name in the
  4394.      phonebook entry editor (for more information see Phonebook entry
  4395.      panel).  If enabled, `term' will put all the entries in the
  4396.      phonebook that have the `Auto dial' option set into a dialing list
  4397.      and immediately start to dial after `term' starts up.
  4398.  
  4399. `Auto exit'
  4400.      If the `Auto dial' switch is enabled, this switch will make `term'
  4401.      exit after all the entries in the auto dial list are dialled. To
  4402.      avoid exiting, hit the `Cancel' in the dialer.
  4403.  
  4404. `Load...'
  4405.      Loads the contents of a telephonebook from a file.
  4406.  
  4407. `Merge...'
  4408.      Loads phonebook entries from a file and merges them with the
  4409.      currently loaded phonebook.
  4410.  
  4411. `Save...'
  4412.      Saves the contents of a telephonebook to a file.
  4413.  
  4414. `Print...'
  4415.      This button will cause another control panel window to be opened,
  4416.      see Printing panel for more information.
  4417.  
  4418. `Sort...'
  4419.      Opens the sort window:
  4420.  
  4421.     `Criteria'
  4422.           This is where you select by which criteria the visible
  4423.           phonebook entries should be selected. `Name', `Number' and
  4424.           `Comment' should speak for themselves, `Selection' will sort
  4425.           the entries by the order of tag numbers.
  4426.  
  4427.     `Reverse order'
  4428.           Enable this switch to reverse the sort order.
  4429.  
  4430.     `Sort'
  4431.           Sorts the entries, keeps the sort window open.
  4432.  
  4433.     `Sort+Close'
  4434.           Sorts the entries and closes the sort window.
  4435.  
  4436.     `Close'
  4437.           Closes the sort window, does not sort.
  4438.  
  4439. `Copy config...'
  4440.      A lot of time can be saved by copying selected parts of the global
  4441.      configuration to a local configuration which is part of a phonebook
  4442.      entry. Selecting this button will invoke a control panel which
  4443.      allows to select which parts of the global configuration should be
  4444.      copied. The control panel also remembers which parts were copied
  4445.      when it was invoked the last time, see Copy panel for more
  4446.      information.
  4447.  
  4448. Phonebook entry panel
  4449. =====================
  4450.  
  4451. `System name'
  4452.      This is where you pick the name under which this entry should show
  4453.      up in the list.
  4454.  
  4455. `Comment'
  4456.      A comment to associate with the entry, it will be displayed in the
  4457.      main window below the list.
  4458.  
  4459. `Numbers'
  4460.      The telephone numbers of the entry.
  4461.  
  4462.      If a system supports multiple lines, the phone number of each line
  4463.      may be entered, each one separated by a vertical bar `|' character
  4464.      (example: `123456|654321' would cause the dialing routine to dial
  4465.      the numbers `123456' and `654321'). The dialing routine will
  4466.      process all these phone numbers before proceeding to the next
  4467.      phonebook entry.
  4468.  
  4469.      The `|' character also works for the modem init, modem exit and
  4470.      dial prefix sequences. Whenever the dialing routine dials another
  4471.      phone number from a list separated by bars, it will try to find a
  4472.      matching init/exit/dial prefix sequence. If more phone numbers are
  4473.      specified than sequences are available, it will use the last
  4474.      sequence given (an example:  a phone number may be given as
  4475.      `123456|654321|12345', the dial prefix text may be `ATDP|ATDT';
  4476.      the dialing routine will call the first number using `ATDP123456',
  4477.      the second number using `ATDT654321' and the third number, since
  4478.      no special dial prefix is available, again using `ATDT12345').
  4479.  
  4480.      *Note: if you do not enter a phone number you will be unable to
  4481.      use the entry for dialing.*
  4482.  
  4483. `Quick menu'
  4484.      If this switch is in effect, the corresponding phonebook entry will
  4485.      be put into the `quick dialing menu' (see at the right hand side
  4486.      of the main menu). Selecting the menu entry will dial the
  4487.      corresponding phone number. Note: only up to 50 phone numbers can
  4488.      be put into the list.
  4489.  
  4490. `Auto dial'
  4491.      Marks this entry for auto dialing. For more information on this
  4492.      feature, see Phonebook.
  4493.  
  4494. `Hide'
  4495.      If this switch is enabled, the contents of the `User name' and
  4496.      `Login password' text entry fields below will be obscured. If you
  4497.      wish to edit these, you must disable this switch.
  4498.  
  4499. `User name'
  4500. `Login password'
  4501.      Here you can store information to be used later for login scripts
  4502.      and such.
  4503.  
  4504. `Settings'
  4505.      This group contains entries which consist of a checkbox and a
  4506.      button.  If the button is disabled, the phonebook entry will not
  4507.      use the settings controlled by the button.
  4508.  
  4509.      This concept is central to how the phonebook works and stores,
  4510.      which is why it needs a bit more explanation.
  4511.  
  4512.      When you start up `term', it loads its global configuration data
  4513.      from a certain file. This global configuration normally reflects
  4514.      the most frequently used settings, they do not necessarily need to
  4515.      change between different phonebook entries. For example, if you
  4516.      only use one modem the modem settings will probably be the same
  4517.      for all phonebook entries. If it's the same, disable the checkbox
  4518.      corresponding to the modem settings in every phonebook entry.
  4519.      Repeat for every other settings item that never needs to change.
  4520.      When the dialer eventually makes a connection, it copies all the
  4521.      settings items of the entry it has connected to into the global
  4522.      configuration that have the checkboxes enabled. If you want to use
  4523.      special settings for a phonebook entry, enable the checkbox you
  4524.      want, press the button next to it and edit the settings.
  4525.  
  4526. `|<'
  4527.      Moves to the first tagged entry.
  4528.  
  4529. `<'
  4530.      Moves to the previous tagged entry.
  4531.  
  4532. `>'
  4533.      Moves to the next tagged entry.
  4534.  
  4535. `>|'
  4536.      Moves to the last tagged entry.
  4537.  
  4538. `Close'
  4539.      Closes the edit window.
  4540.  
  4541. Rate panel
  4542. ==========
  4543.  
  4544.    `term' will count the minutes you are online and connected to a BBS
  4545. as soon as a connection is made through the dialing routine. As soon as
  4546. the connection is lost or you hang up, `term' will use the information
  4547. to be specified in this control panel to calculate the amount of money
  4548. to be paid for the call.
  4549.  
  4550. `Pay/unit'
  4551.      The amount of money to be paid for each single time unit when
  4552.      online.  This fee must be given in the smallest currency unit
  4553.      available (pence, cents, centimes, etc.).
  4554.  
  4555. `Sec./unit'
  4556.      This is where you enter how many seconds each time unit lasts.
  4557.  
  4558.    There are two different groups of the two entries listed above
  4559. available:  one for the first unit and one for all following units. So,
  4560. if you only pay for the call you make but not for the time you spend
  4561. making it, just enter the fee in the first group and set the second
  4562. group to zero.
  4563.  
  4564. `Days and dates'
  4565.      This list contains the default rate settings and exceptions for
  4566.      certain dates and days of the week. Each line displays the type of
  4567.      the entry and a comment (separated by the `>>' character). The
  4568.      following types are available:
  4569.  
  4570.     `Day(s)'
  4571.           Settings for certain days of the week
  4572.  
  4573.     `12. Jan (example)'
  4574.           Settings for a specific date
  4575.  
  4576.      If there is no special type available for an entry, it's probably
  4577.      the default settings you are dealing with. These settings are used
  4578.      whenever `term' cannot find an entry for the current day.
  4579.  
  4580.    For each entry in this list there is at least one associated starting
  4581. time available which defines when the associated rate settings are to be
  4582. used. You will find the time settings in the list titled `Time'. To add
  4583. a new time use the `Add' button. To edit an existing entry use the
  4584. `Edit' button. To remove an entry, press the `Remove' button.
  4585.  
  4586. `Add date'
  4587.      Will invoke a control panel to create a new rate entry to be used
  4588.      on a specific date. Use the sliders and button to select the day
  4589.      the settings will be valid for.
  4590.  
  4591. `Add day(s)'
  4592.      Will create a new rate entry referring to one or more days of the
  4593.      week.  Use the buttons of the control panel to select the days the
  4594.      current settings will be valid for.
  4595.  
  4596. `Import'
  4597.      Much work can be saved if the rate settings for the current
  4598.      phonebook entry are imported (or copied) from a different
  4599.      phonebook entry. To do so, select this button. The control panel
  4600.      to be opened will display the list of phonebook entries available
  4601.      and three buttons:
  4602.  
  4603.     `Replace rates'
  4604.           The rate settings of the current phonebook entry will be
  4605.           replaced by the settings of the selected entry.
  4606.  
  4607.     `Append rates'
  4608.           The rate settings of the selected entry will be appended to
  4609.           the current phonebook entry.
  4610.  
  4611.     `Cancel'
  4612.           Will abort the selection.
  4613.  
  4614.    Whenever a rate entry is selected, the corresponding parameters
  4615. (`Pay/unit' and `Sec./unit') can be edited. If the entry refers to a
  4616. certain date or a specific day of week three additional buttons are
  4617. made available:
  4618.  
  4619. `Edit'
  4620.      Just as the labels says, will allow you to modify an entry after
  4621.      it has been created.
  4622.  
  4623. `Clone'
  4624.      Will duplicate the current rate entry and append it to the list.
  4625.  
  4626. `Remove'
  4627.      Removes an entry from the list.
  4628.  
  4629. Copy panel
  4630. ==========
  4631.  
  4632.    This control panel allows you to select which parts of the global
  4633. configuration to copy into the currently selected phonebook entry.
  4634.  
  4635. `To all entries'
  4636.      The selected parts will be copied to all phonebook entries. If any
  4637.      phonebook entries are selected when this action is to be performed,
  4638.      only the selected entries will be affected.
  4639.  
  4640. `Copy'
  4641.      This is where you select from which source the configuration
  4642.      information will be copied:
  4643.  
  4644.     `Global configuration'
  4645.           Parts of the currently active global configuration will be
  4646.           copied.
  4647.  
  4648.     `Defaults'
  4649.           When going online, instead of overriding the currently active
  4650.           global configuration with the supplied local phonebook
  4651.           configuration the corresponding global configuration will be
  4652.           left unchanged.
  4653.  
  4654. `Select all'
  4655.      Selects all parts.
  4656.  
  4657. `Clear all'
  4658.      Clears the current selection.
  4659.  
  4660. `Use'
  4661.      Copies the selected items.
  4662.  
  4663. `Cancel'
  4664.      The window is closed, no items are copied.
  4665.  
  4666. Dial panel
  4667. ==========
  4668.  
  4669.    The following information about the dialing process is displayed:
  4670.  
  4671. `Calling'
  4672.      The name of the telephonebook entry belonging to the number being
  4673.      dialled. If it is just a telephone number the text `<< Unknown >>'
  4674.      is shown, indicatinging that the name of the BBS is unknown.
  4675.  
  4676. `Comment'
  4677.      This is where the comment corresponding to the current dialing list
  4678.      entry is displayed.
  4679.  
  4680. `Number'
  4681.      The telephone number being dialed or just dialed.
  4682.  
  4683. `Next'
  4684.      The name of the phonebook entry which will be processed next if no
  4685.      connection is established. If no further entry exists, "-" will be
  4686.      displayed.
  4687.  
  4688. `Timeout'
  4689.      A counter which is decreased every second and which reflects the
  4690.      time remaining to establish a connection or to cycle through the
  4691.      dial queue again.
  4692.  
  4693. `Attempt'
  4694.      This field shows the number of unsuccessful cycles made through the
  4695.      dialing queue to establish a connection.
  4696.  
  4697. `Message'
  4698.      A message to the user. This can be:
  4699.  
  4700.     `Dialing...'
  4701.           A dial is in process.
  4702.  
  4703.     `Line is busy.'
  4704.           The dialed number is engaged.
  4705.  
  4706.     `Incoming call!'
  4707.           The modem has been called from another modem.
  4708.  
  4709.     `Incoming voice call!'
  4710.           The modem is receiving a call which was not originated by
  4711.           another modem.
  4712.  
  4713.     `No dialtone detected!'
  4714.           The modem was unable to detect any dialing tone on the line,
  4715.           it may possibly be not connected.
  4716.  
  4717.     `Connection established.'
  4718.           Just as the name says...
  4719.  
  4720.     `Maximum number of dial retries reached!'
  4721.           Just as the name says...
  4722.  
  4723.     `Dial attempt timeout.'
  4724.           The time available to establish a connection has been reached
  4725.           or exceeded.
  4726.  
  4727.     `Redial Delay...'
  4728.           Pause until the next cycle through the dialing queue.
  4729.  
  4730.    Additionally, the following controls are available:
  4731.  
  4732. `Skip'
  4733.      With this function the current dialing attempt is cancelled and
  4734.      the next number is processed. If no succeeding telephone number
  4735.      exists `term' waits for the next cycle through the dial queue or
  4736.      until `Skip call' is pressed again.
  4737.  
  4738.      There also is a hotkey combination available to accomplish the same
  4739.      task.
  4740.  
  4741. `Remove'
  4742.      This button works in part similar to the `Skip call' button.
  4743.      Additionally, it removes the current phonebook entry from the
  4744.      dialing list.
  4745.  
  4746. `Go to online'
  4747.      If the line is very noisy, the connection to a mailbox may have
  4748.      been made, but the `CONNECT' text may be got lost. Pressing this
  4749.      button will cause `term' to assume that the modem is in fact
  4750.      online now, start the rates accounting and return you to the main
  4751.      window.
  4752.  
  4753. `Stop dialing'
  4754.      Operation of this button exits the dial queue (leaving the the dial
  4755.      queue intact) and ends the dialing process.
  4756.  
  4757. `Start script recording on connection'
  4758.      As soon as the connection is establish `term' will start recording
  4759.      incoming text and your responses to it, thus making it possible to
  4760.      create auto-login scripts and such. For more information on this
  4761.      topic see Script recording.
  4762.  
  4763.    If a connection is successfully made the corresponding entry in the
  4764. dial queue will be removed.
  4765.  
  4766.    Selecting the close gadget will close the window and cause the phone
  4767. book panel to be reopened.
  4768.  
  4769. Printing panel
  4770. ==============
  4771.  
  4772.    This control panel is part of the phonebook. It is opened whenever
  4773. the `Print' button is selected and allows for setting the output
  4774. options.
  4775.  
  4776. `Output file or device'
  4777.      This is where you enter the name of the file or device (such as
  4778.      `PRT:') the phonebook printout is to be sent to.
  4779.  
  4780. `Plain text'
  4781.      If enabled only the plain and bare information text will be
  4782.      printed, else text attribute control sequences will be sent as
  4783.      well.
  4784.  
  4785. `Include...'
  4786.      Each switch determines whether the corresponding phonebook entry
  4787.      information will be included in the printout.
  4788.  
  4789. `Use'
  4790.      Will start printing the phonebook contents.
  4791.  
  4792. `Cancel'
  4793.      Returns to the phonebook.
  4794.  
  4795. Trap panel
  4796. ==========
  4797.  
  4798.    By default `term' scans the input data stream for a set of special
  4799. character sequences, such as `NO CARRIER', `RING' and `VOICE',
  4800. depending on how your modem settings (see Modem panel) are set up. The
  4801. trap panel permits adding custom character sequences which if found
  4802. cause `term' to execute the corresponding command sequences (see
  4803. Command sequences).  This makes it possible to write auto-login
  4804. procedures by just adding traps for the user name and password prompts.
  4805. For example, suppose your BBS prompts you to enter your user name with
  4806. the text `User name:' and to enter your password with the text
  4807. `Password:'. You would create two trap entries, one with `User name:'
  4808. as the sequence and `\u\r' as the command and one with `Password:' as
  4809. the sequence and `\p\r' as the command. Provided the phonebook entry is
  4810. set up correctly (see Phonebook, User/Password) connecting to the
  4811. system will log you in `automatically'.
  4812.  
  4813.    The trap settings editor consists of the following controls:
  4814.  
  4815. `Trap list'
  4816.      This list contains all the trap sequences `term' knows.
  4817.  
  4818. `Sequence'
  4819.      This text entry field contains the currently selected sequence.
  4820.  
  4821. `Command'
  4822.      This text entry field contains the command sequence (see Command
  4823.      sequences) to be executed when the corresponding trap sequence is
  4824.      found.
  4825.  
  4826. `|<'
  4827.      Move the currently selected entry to the beginning of the list.
  4828.  
  4829. `<'
  4830.      Move the currently selected entry up in the list.
  4831.  
  4832. `>'
  4833.      Move the currently selected entry down in the list.
  4834.  
  4835. `>|'
  4836.      Move the currently selected entry to the end of the list.
  4837.  
  4838. `New'
  4839.      A new trap list entry is added, prompting you to edit it.
  4840.  
  4841. `Remove'
  4842.      Removes the currently selected list entry
  4843.  
  4844. `Clear'
  4845.      Removes all entries from the list, clearing it.
  4846.  
  4847. `Use'
  4848.      Closes the window, using the current trap settings.
  4849.  
  4850. `Load'
  4851.      Loads the trap settings from a file.
  4852.  
  4853. `Save'
  4854.      Stores the trap settings in a file. *Note: `term' reads the
  4855.      default settings from the file *trap.prefs*, so make sure your
  4856.      trap settings are named accordingly if you wish to use them upon
  4857.      startup*.
  4858.  
  4859. File upload panel
  4860. =================
  4861.  
  4862.    `term' permits building a list of files to upload before the upload
  4863. is started. This list can be built in many ways, such as by dropping
  4864. the icons of the files to send on the icon labeled `term Upload queue',
  4865. by dropping the icons on the upload panel window, by entering the names
  4866. of the files in the upload panel window or by using the file requester.
  4867.  
  4868.    There are two ways to open the file upload panel. You can
  4869. double-click on the `term Upload queue' icon or use the main menu entry
  4870. `Upload queue'. It includes the following controls:
  4871.  
  4872. `Files to upload'
  4873.      This is the list of files to be sent. The text entry field below
  4874.      serves to add new file names or to edit the currently selected
  4875.      file name.
  4876.  
  4877. `Add files'
  4878.      Clicking on this button brings up a file requester to add new
  4879.      files to the list. You can select files from one drawer at a time.
  4880.      The file requester will pop up over and over again asking you to
  4881.      add more files until you press the `Done' button.
  4882.  
  4883. `Add'
  4884.      Click on this button to add another file name to the list, you
  4885.      will be prompted to type in its name.
  4886.  
  4887. `Remove'
  4888.      Press this button to remove the currently selected entry from the
  4889.      list.
  4890.  
  4891. `Clear'
  4892.      In order to remove all entries from the list, clearing it, press
  4893.      this button.
  4894.  
  4895. `Binary upload'
  4896.      Use this button to upload the listed files in binary mode.
  4897.  
  4898. `Text upload'
  4899.      Press this button to upload the listed files in text mode.
  4900.  
  4901. `Hide'
  4902.      Click on this button to hide the file upload panel. The list
  4903.      contents will be stored.
  4904.  
  4905. Area code panel
  4906. ===============
  4907.  
  4908.    In the phonebook (see Phonebook) phone rate accounting information
  4909. can be assigned to individual entries. The area code panel permits to
  4910. assign phone rate accounting information to the phone numbers
  4911. themselves, so even the `Dial phone number' menu function will take
  4912. advantage of it.  The area codes in each phone number determine the
  4913. rates accounting information to associate with it. In the area code
  4914. list you assign a name to each entry and a pattern to match a single or
  4915. multiple area codes; next you configure the rates parameters to use for
  4916. this entry.
  4917.  
  4918.    The area code rates accounting settings are not meant to replace the
  4919. individual rates settings in the phonebook, but they have priority over
  4920. them.
  4921.  
  4922.    The area code panel sports the following controls:
  4923.  
  4924. `Groups'
  4925.      This is the list of area code groups, the single entries are
  4926.      edited below.
  4927.  
  4928. `Name'
  4929.      A name or title for an area group entry.
  4930.  
  4931. `Pattern'
  4932.      The area code patterns are configured here. If you wish to have an
  4933.      entry correspond to area codes starting with `009' you would enter
  4934.      `009#?' here. The pattern syntax follows the AmigaDOS wildcard
  4935.      pattern syntax, so for example multiple area codes can be easily
  4936.      combined, e.g. `009' and `007' could be combined as `(009|007)#?'.
  4937.      See your `Using the system software' manual for more information.
  4938.  
  4939.      `term' scans the area code list top-down, i.e. for two consecutive
  4940.      entries `009#?' and `0097#?' the number `00971324' would match the
  4941.      first entry, but not the second.
  4942.  
  4943. `|<'
  4944.      Moves the currently selected entry to the beginning of the list.
  4945.  
  4946. `<'
  4947.      Moves the currently selected entry up in the list.
  4948.  
  4949. `>'
  4950.      Moves the currently selected entry down in the list.
  4951.  
  4952. `>|'
  4953.      Moves the currently selected entry to the end of the list.
  4954.  
  4955. `New'
  4956.      Creates a new area code entry and prompts you to edit it.
  4957.  
  4958. `Remove'
  4959.      Removes the currently selected area code entry from the list.
  4960.  
  4961. `Clear'
  4962.      Removes all area code entries from the list, clearing it.
  4963.  
  4964. `Edit'
  4965.      Brings up the rates editing window for the currently selected
  4966.      entry. See Rate panel for more information.
  4967.  
  4968. `Use'
  4969.      Closes the window, keeps the current settings.
  4970.  
  4971. `Load'
  4972.      Loads the area code & rates accounting information from a file.
  4973.  
  4974. `Save'
  4975.      Saves the area code & rates accounting information to a file.
  4976.      Upon startup `term' will read the default area code & rates
  4977.      accounting information from a file named `rates.prefs', so make
  4978.      sure that your settings file is named correctly for `term' to find
  4979.      it.
  4980.  
  4981. Parameter panel
  4982. ===============
  4983.  
  4984.    When `term' invokes an external program which is to handle the job
  4985. of transferring files it can pass special parameters to the program on
  4986. the command line, such as drawer names. This control panel helps you to
  4987. build a command line for the program in question.
  4988.  
  4989. `Command'
  4990.      This is where you enter the command to invoke, such as `run
  4991.      hydracom'.
  4992.  
  4993. `1 File'
  4994.      This adds `%f' to the command line. When the program is invoked a
  4995.      file requester will prompt you to select one single file. Its name
  4996.      will appear in place of the `%f' characters in the list of
  4997.      arguments passed to the program.
  4998.  
  4999. `Files'
  5000.      This adds `%m' to the command line. When the program is invoked a
  5001.      file requester will prompt you to select a list of files. Their
  5002.      names will appear in place of the `%m' characters in the list of
  5003.      arguments passed to the program.
  5004.  
  5005. `Port'
  5006.      This adds `%p' to the command line. When the program is invoked
  5007.      the name of the ARexx port `term' uses will appear in place of the
  5008.      `%p' characters in the list of arguments passed to the program.
  5009.  
  5010. `Device'
  5011.      This adds `%d' to the command line. When the program is invoked
  5012.      the name of the serial device driver `term' uses (see Serial
  5013.      panel) will appear in place of the `%d' characters in the list of
  5014.      arguments passed to the program.
  5015.  
  5016. `Unit'
  5017.      This adds `%u' to the command line. When the program is invoked
  5018.      the unit number of the serial device driver `term' uses (see
  5019.      Serial panel) will appear in place of the `%u' characters in the
  5020.      list of arguments passed to the program.
  5021.  
  5022. `Source'
  5023.      This adds `%<' to the command line. When the program is invoked
  5024.      the name of the drawer files to send should be found in (see Path
  5025.      panel) will appear in place of the `%<' characters in the list of
  5026.      arguments passed to the program.
  5027.  
  5028. `Dest.'
  5029.      This adds `%>' to the command line. When the program is invoked
  5030.      the name of the drawer files should be placed in when received
  5031.      (see Path panel) will appear in place of the `%>' characters in
  5032.      the list of arguments passed to the program.
  5033.  
  5034. `Screen'
  5035.      This adds `%s' to the command line. When the program is invoked
  5036.      the name of the public screen `term' uses (see Screen panel) will
  5037.      appear in place of the `%s' characters in the list of arguments
  5038.      passed to the program. *Please note that instead of the name of a
  5039.      screen an empty string may appear.*
  5040.  
  5041. `Baud rate'
  5042.      This adds `%b' to the command line. When the program is invoked
  5043.      the currently selected baud rate (see Serial panel) `term' uses
  5044.      will appear in place of the `%b' characters in the list of
  5045.      arguments passed to the program.
  5046.  
  5047. `Connect. rate'
  5048.      This adds `%c' to the command line. When the program is invoked
  5049.      the baud rate the modem made the connection with will appear in
  5050.      place of the `%c' characters in the list of arguments passed to
  5051.      the program. *Please note that if the modem is not currently
  5052.      online `%c' will produce the same number `%b' does.*
  5053.  
  5054. `Use'
  5055.      Keeps the current settings.
  5056.  
  5057. `Cancel'
  5058.      Discards the current settings.
  5059.  
  5060.    For more information on the escape sequences introduced by `%' see
  5061. Escape sequences.
  5062.  
  5063. Signature panel
  5064. ***************
  5065.  
  5066.    `term' will let you choose from a number of predefined signatures
  5067. for use with file transfer protocols. Just pick the signature you need.
  5068. Please note that different signatures will be presented for upload and
  5069. download protocols.  For more information on signatures, see Protocol
  5070. signatures.
  5071.  
  5072. Data transfer
  5073. *************
  5074.  
  5075.    One of the important features `term' offers are means to transfer
  5076. data from one computer to another conveniently. This is accomplished by
  5077. using so-called XPR libraries and external programs which `term' will
  5078. invoke when necessary.
  5079.  
  5080. Data transfer via XPR library
  5081. =============================
  5082.  
  5083.    The so-called XPR libraries implement one or more file transfer
  5084. protocols in the form of an Amiga shared library. They offer a
  5085. standardized interface for settings their protocol options and for
  5086. transferring data. Some XPR libraries will handle file transfers all on
  5087. their own, e.g. if the remote initiates an upload the XPR library will
  5088. respond by automatically starting a download.
  5089.  
  5090.    Of particular importance is the `Default protocol' (see Transfer
  5091. panel).  If you have selected an XPR library for this protocol, the
  5092. library will remain open during the entire `term' session. For the
  5093. Z-Modem protocol as implemented through `xprzmodem.library' this means
  5094. that the XPR library will automatically handle downloads when initiated
  5095. by the remote.
  5096.  
  5097. Data transfer via external program
  5098. ==================================
  5099.  
  5100.    `term' can make use of external programs for the purpose of
  5101. transferring data. Whenever the corresponding file transfer function is
  5102. invoked, `term' will try to run the selected program. While the program
  5103. is running `term' will temporarily halt its serial I/O processing, so
  5104. programs which permit sharing the serial device driver with `term' can
  5105. immediately pick up the ball and start transferring data. Please note
  5106. that this feature requires `term' to open the serial device driver in
  5107. shared access mode (see Serial panel).
  5108.  
  5109.    Almost every external program will need a few command line options to
  5110. know its whereabouts, such as the serial device driver to use or which
  5111. files to transfer. You can provide this information by editing the
  5112. command line (see Parameter panel) to include special escape sequences
  5113. `term' will expand into data. The following line could be put into the
  5114. binary `Receive' text entry field:
  5115.  
  5116.      run hydracom device %p speed %b line %c nocarrier rec %> get
  5117.  
  5118.    This will invoke the `Hydracom' program which implements the Hydra
  5119. protocol which sports bidirectional file transfer and also adds a chat
  5120. option. This is what the line can expand into when `term' runs the
  5121. program:
  5122.  
  5123.      run hydracom device TERM speed 38400 line 14400
  5124.         nocarrier rec Work:Downloads get
  5125.  
  5126.    `%p' expands into the ARexx port name `term' uses, `%b' into the
  5127. baud rate currently used, `%c' into the baud rate the modem made the
  5128. connection with and `%>' into the name of the drawer files received
  5129. should be placed in.
  5130.  
  5131.    To complete this example, the following line could be put into the
  5132. binary `Send' text entry field:
  5133.  
  5134.      run hydracom device %p speed %b line %c nocarrier rec %> send %m
  5135.  
  5136.    When `term' runs this program, it will first prompt you to select the
  5137. files to send, this is what `%m' does. The files names will then appear
  5138. in place of the `%m' characters.
  5139.  
  5140.    For more information on the escape sequences introduced by the `%'
  5141. character, see Escape sequences.
  5142.  
  5143.    Please note that for `term' to find the external programs they must
  5144. either reside in the AmigaDOS Shell search path or need to be prefixed
  5145. by the complete AmigaDOS path their are located in.
  5146.  
  5147.    `term' runs the programs in synchronous fashion. Some protocols, such
  5148. as `hydracom', however need to be run asynchronously. For such programs
  5149. it is recommended to prefix the command line with the `run' command.
  5150.  
  5151. Protocol signatures
  5152. ===================
  5153.  
  5154.    Some file transfer protocols sport automatic download and upload
  5155. functions.  At the beginning of a data transmission they send a special
  5156. data sequence to the remote, indicating that the local side is ready
  5157. for action. This data is called a signature. With `term' you can assign
  5158. a specific signature to each upload and download protocol (see Transfer
  5159. panel). When `term' sees this signature in the incoming data stream the
  5160. corresponding protocol will be invoked.
  5161.  
  5162.    A signature usually consists of a unique sequence of characters,
  5163. some of which may not be printable or visible on the screen. This is
  5164. why the standard command sequence syntax is employed for entering
  5165. signature text (see Command sequences).
  5166.  
  5167.    You should avoid using a single signature for more than one
  5168. protocol. As `term' scans the input data stream it will always invoke
  5169. the first protocol which sports a matching signature. Signatures are
  5170. scanned in the following order:
  5171.  
  5172.    `Default protocol (upload)'
  5173.  
  5174.    `Default protocol (download)'
  5175.  
  5176.    `ASCII upload'
  5177.  
  5178.    `ASCII download'
  5179.  
  5180.    `Text upload'
  5181.  
  5182.    `Text download'
  5183.  
  5184.    `Binary upload'
  5185.  
  5186.    `Binary download'
  5187.  
  5188.    Most transfer protocols use different signatures for uploads and
  5189. downloads.  Hydra for example is an exception as it uses the same
  5190. signature for both purposes. Take care, it is recommended to use the
  5191. Hydra signature only for downloads. Some signatures, such as the
  5192. CompuServe Quick B protocol, use very simple signatures which consist
  5193. only of a single character. In the case of the Quick B protocol this
  5194. would be the `ENQ' character which is easily generated by spurious line
  5195. noise. In this case the protocol may start up expecting a file transfer
  5196. and find out rather soon that none is taking place. Although single
  5197. character signatures are supported it is recommended not to use them.
  5198.  
  5199.    Some XPR libraries implement auto-upload and auto-download functions
  5200. all on their own. A common feature is that the signatures that trigger
  5201. these functions will not turn up in the input data stream `term'
  5202. receives as the protocols will filter them out. Consequently, the
  5203. `term' supplied protocol auto-invocation may not work. Be prepared to
  5204. handle this.
  5205.  
  5206. Escape sequences
  5207. ================
  5208.  
  5209.    When invoking external programs to use for transferring data `term'
  5210. will build a command line based upon the template given in the transfer
  5211. settings editor (see Transfer panel). This template can include special
  5212. tokens, known as escape sequences. Unlike the so-called command
  5213. sequences (see Command sequences) they are introduced by a percent
  5214. character (%) and can only be used with external file transfer
  5215. programs. Please note that you cannot mix command sequences with escape
  5216. sequences.
  5217.  
  5218.    The following escape sequences are supported:
  5219.  
  5220. `%f (Single file name)'
  5221.      Inserts a single file name when the program is run. A file
  5222.      requester will open if necessary. If there are still files in the
  5223.      upload queue (see File upload panel) and an upload is to take place
  5224.      the first file name will be inserted and no file requester will
  5225.      appear.
  5226.  
  5227.      *Note: Case matters; %f inserts the file name along with its
  5228.      complete path, %F inserts the plain file name only, omitting the
  5229.      path.*
  5230.  
  5231. `%m (Multiple file names)'
  5232.      Inserts a list of file names when the program is run. A file
  5233.      requester will open if necessary. If there are still files in the
  5234.      upload queue (see File upload panel) and an upload is to take place
  5235.      their names will be inserted and no file requester will appear.
  5236.  
  5237.      *Note: Case matters; %m inserts the file names along with their
  5238.      complete paths, %M inserts the plain file names only, omitting
  5239.      their paths.*
  5240.  
  5241. `%p (Port name)'
  5242.      Inserts the ARexx port name `term' is currently using.
  5243.  
  5244. `%d (Device name)'
  5245.      Inserts the name of the serial device driver `term' is currently
  5246.      using (see Serial panel).
  5247.  
  5248. `%u (Unit number)'
  5249.      Inserts the unit number of the serial device driver `term' is
  5250.      currently using (see Serial panel).
  5251.  
  5252. `%< (Source drawer)'
  5253.      Inserts the name of the drawer files to be uploaded should be
  5254.      found in. This name will be different for ASCII, text and binary
  5255.      transfers. The default protocol will always use the binary upload
  5256.      path (see Path panel and Transfer panel).
  5257.  
  5258. `%> (Destination drawer)'
  5259.      Inserts the name of the drawer files to be received should be
  5260.      placed in. This name will be different for ASCII, text and binary
  5261.      transfers. The default protocol will always use the binary
  5262.      download path (see Path panel and Transfer panel).
  5263.  
  5264. `%s (Screen name)'
  5265.      Inserts the name of the public screen `term' is using.
  5266.  
  5267.      *Note: This may be an empty string. Be prepared to handle this.*
  5268.  
  5269. `%b (Baud rate)'
  5270.      Inserts the baud rate `term' is currently using (see Serial panel).
  5271.  
  5272. `%c (Connection rate)'
  5273.      Inserts the baud rate the modem made the connection with.
  5274.  
  5275.      *Note: This value may be the same as given by %b if the modem is
  5276.      not currently online.*
  5277.  
  5278. `%% (Percent sign)'
  5279.      Inserts the percent sign.
  5280.  
  5281. How to set up Hydracom?
  5282. =======================
  5283.  
  5284.    In case you don't know already what Hydracom is: it is a
  5285. bidirectional file transfer protocol which also sports a chat option.
  5286. It permits to send and receive data at the same time. So far, Hydracom
  5287. versions exist for the IBM-PC, the Atari ST and the Amiga of course.
  5288.  
  5289.    With the introduction of `term' v4.0 an interface was added to the
  5290. Hydracom Amiga port to allow it to take over the serial I/O processing
  5291. from `term'. Note that this requires the Hydracom Amiga port revision 2
  5292. or higher to work.
  5293.  
  5294.    `term' v4.3 will let you choose external programs for use as file
  5295. transfer protocols. Hydracom falls into this cathegory.
  5296.  
  5297.    Please open the transfer settings editor (see Transfer panel) now
  5298. and press the button labeled `Page' three times until the page `Binary
  5299. transfer protocol' becomes visible. This page is divided into two
  5300. parts. The top half controls the upload protocol and the other half
  5301. controls the download protocol. To use the Hydracom external protocol,
  5302. now do the following: there are two buttons labeled `Type'.  Press them
  5303. both twice until they show `External program'. This will make the
  5304. `Send' and `Receive' text entry fields available.  In the `Send' field
  5305. enter the following line:
  5306.  
  5307.      run hydracom device %p speed %b line %c nocarrier rec %> send %m
  5308.  
  5309.    In the `Receive' field enter the following line:
  5310.  
  5311.      run hydracom device %p speed %b line %c nocarrier rec %> get
  5312.  
  5313.    The `Hydracom' command must be prefixed with the `Run' command due
  5314. to the way the protocol interacts with `term'. For other protocols the
  5315. `Run' prefix may be omitted.
  5316.  
  5317.    Now close the window by pressing the `Use' button. Now Hydracom is
  5318. configured as the binary file transfer protocol. To receive files using
  5319. the protocol, select the menu item `Download binary file(s)', to send
  5320. and receive files at the same time (Hydracom is a bidirectional file
  5321. transfer protocol) select `Upload binary file(s)'.
  5322.  
  5323.    If you wish to use the Hydracom signature (see Signature panel and
  5324. Transfer panel) to auto-start transmissions, you need to keep a few
  5325. things in mind. The signature is identical both for uploads and
  5326. downloads, but using it for both purposes is not a good idea. `term'
  5327. will always pick the upload signature first. Hydracom is a bidirectional
  5328. file transfer protocol which allows you to send and receive files at
  5329. the same time. This works only when invoking an upload, but not when
  5330. running a download. If you select a download signature you will lose the
  5331. bidirectional transfer feature. It is recommended to start transmissions
  5332. manually.
  5333.  
  5334.    This setup will always let you transfer data only in one direction.
  5335. In order to take advantage of the bidirectional transfer feature Hydra
  5336. offers you will need to make use of two ARexx scripts that should have
  5337. accompanied `term'. You only need to modify the commands for `Send' and
  5338. `Receive' a little:
  5339.  
  5340.    For `Send' enter:
  5341.  
  5342.      AskUpload.term device %p speed %b line %c nocarrier rec %> send %m
  5343.  
  5344.    And for `Receive' enter:
  5345.  
  5346.      AskDownload.term device %p speed %b line %c nocarrier rec %> get
  5347.  
  5348.    Before the transfer starts you will be asked whether you wish to send
  5349. and receive data at the same time or whether data should be transmitted
  5350. only in one direction.
  5351.  
  5352. Configuration hints
  5353. *******************
  5354.  
  5355.    Admittely, `term' has more configuration options and settings than
  5356. you can shake a stick at. I have received a number of request to
  5357. explain where to start after installing the program:
  5358.  
  5359.   1. Start with the serial settings (see Serial panel). `term' will
  5360.      usually copy your current system preferences settings. If you
  5361.      happen to know that they are correct and worked fine for you in
  5362.      the past you probably don't need to make any changes.  But if you
  5363.      never were quite happy with the setup this is your chance to make
  5364.      it fit.
  5365.  
  5366.      As the lucky owner of a high speed modem to support all those
  5367.      nifty compressing transfer protocols nobody knows how to pronounce
  5368.      correctly (v.32/v.32bis/MNP/etc.) you will probably want to run it
  5369.      at baud rates around 9,600-19,200 bps. If you choose to do so make
  5370.      sure that the `Handshaking' switch is set to `RTS/CTS' or data is
  5371.      easily lost during transmissions.
  5372.  
  5373.      *Note: some modems will lock up if the `RTS/CTS' handshaking
  5374.      protocol is enabled although they should support it. In most cases
  5375.      the modem behaviour can be changed. First turn off `RTS/CTS'
  5376.      handshaking (set it to `None'), then enter `AT&S0' and press
  5377.      return, and finally turn on `RTS/CTS' Handshaking on again. Your
  5378.      modem should now respond properly to your commands. To make this
  5379.      change permanent, enter `AT&W' and press return to store the
  5380.      current modem profile in its nonvolatile RAM.*
  5381.  
  5382.      Older modem hardware usually supports only a fixed number of baud
  5383.      rates, mostly up to 2,400 bps. Do not enable `RTS/CTS'
  5384.      handshaking, leave it turned off. In fact if you don't turn it off
  5385.      `term' will have trouble sending and receiving data.
  5386.  
  5387.      Make sure that the baud rate fits and your modem supports it.
  5388.      Modern modem hardware usually can adjust to the baud rate you
  5389.      choose, older modems will send & receive illegible gibberish if
  5390.      addressed at the wrong baud rate. Not unheard of are modems which
  5391.      can communicate with the terminal program only at fixed baud
  5392.      rates: while they are happy with 9,600 bps they might find 14,400
  5393.      bps not at all worth responding to. I recommend that you try
  5394.      several baud rate settings until one is found to fit.
  5395.  
  5396.      If you don't want to use the built-in Amiga serial port hardware
  5397.      you will want to change the device name and unit number settings.
  5398.      Your I/O expansion hardware manual will tell you which name to
  5399.      choose and which device unit numbers are valid.
  5400.  
  5401.      The serial panel (see Serial panel) sports a number of additional
  5402.      options. *Do not change them right now!* In particular stay away
  5403.      from that sexy `High-speed mode' button and don't let the `Buffer
  5404.      size' slider tempt you. Return from the serial settings to the
  5405.      main menu by clicking on the `Use' button and save your current
  5406.      setup back to disk using the `Save settings' menu item.
  5407.  
  5408.   2. Proceed to the modem settings (see Modem panel) and take a look at
  5409.      the switch labeled `Dial mode'. A modem usually dials phone
  5410.      numbers either using a technique called `tone' or `pulse' dialing.
  5411.      Technically, tone dialing requires your local phone net operator
  5412.      (some kind of computer) to listen to a sequence of sounds which
  5413.      represent the single digits of the phone number dialled. Pulse
  5414.      dialing involves getting a number of electric pulses, each of
  5415.      which represents a digit of the phone number, transmitted across
  5416.      the line. Tone dialing is usually much faster than pulse dialing,
  5417.      but it isn't supported all over the world. If the receiver of your
  5418.      phone reports a number of beeping sounds when you dial a number
  5419.      you can use tone dialing.  If you hear rattling sounds it's
  5420.      probably pulse dialing for you. Let's get back to the `Dial mode',
  5421.      if you wish to use pulse dialing, set it to `Pulse', otherwise set
  5422.      it to `Tone'.
  5423.  
  5424.      Leave the rest of the modem setup as it is, do not change the
  5425.      `Connect auto baud' switch.
  5426.  
  5427.   3. Next, take a look at the screen settings (see Screen panel). This
  5428.      is where you choose the terminal screen/window look and colours.
  5429.      By default `term' is configured to open a plain four colour screen
  5430.      using the Amiga default font. This should be sufficient unless you
  5431.      plan to spend most of your modeming time in PC-driven BBSes which
  5432.      keep throwing lots of colours at you.
  5433.  
  5434.      Choose how many colours the terminal should use, the switch labeled
  5435.      `Colour' will let you choose between `4 Colours (Amiga)', `8
  5436.      Colours (ANSI)', `16 Colours (EGA)' and `2 Colours (Monochrome)'.
  5437.      Each of these settings has a particular default palette attached.
  5438.      The `Amiga' mode will use your current system default colours.
  5439.      `ANSI' represents the choice of colours the ANSI committee
  5440.      responsible for standardizing a certain terminal command protocol
  5441.      to be the best given the constraints they had. `EGA' reflects
  5442.      whatever the engineers who designed the first Enhanced Graphics
  5443.      Adaptor card for the PC considered to be an enhanced colour
  5444.      palette. `Monochrome' is my idea how an extremely simplistic,
  5445.      while still readable colour choice could look like. Choose what
  5446.      you find appropriate, but keep in mind that the more colours to
  5447.      use the slower screen updates, scrolling and text output will get.
  5448.      Also, a 16 colour high resolution screen will put your system
  5449.      under additional stress if you are running an older Amiga model
  5450.      which is not equipped with the AGA chip set. Careful please, any
  5451.      changes you make will affect the performance of the program!
  5452.  
  5453.      You might want to change the screen mode or the user interface
  5454.      font. When you are satisfied with the setup, return to the main
  5455.      menu.
  5456.  
  5457.   4. Now it's time to edit the terminal settings (see Terminal panel).
  5458.      This is where you control the basic behaviour of the terminal
  5459.      emulation. If you wish to use an IBM PC style font for the
  5460.      terminal display you can do so by changing the `Font' switch to
  5461.      `IBM PC style'. Alternatively, you might find it worth changing
  5462.      the `Text font' instead which is the font to be used for terminal
  5463.      text output. Note that if the `Font' switch is set to anything
  5464.      else but `Standard' your `Text font' settings will be ignored.
  5465.      Well, actually they will not be entirely ignored, but the IBM PC
  5466.      style font will be opened in the point size you selected.
  5467.  
  5468.      Don't touch any other controls, return to the main menu when you
  5469.      are finished.
  5470.  
  5471.   5. If you are likely to visit a lot of PC BBSes, edit the emulation
  5472.      settings now (see Emulation panel). You might want to turn on the
  5473.      switch labeled ``CLS' resets cursor position', otherwise the
  5474.      terminal screen might not get cleared properly when the BBS sends
  5475.      the control codes it considers appropriate for this purpose.
  5476.  
  5477.      Leave the rest of the setup as it is and return to the main menu.
  5478.  
  5479.   6. The next step involves changing the path settings (see Path
  5480.      panel). When receiving files on your machine you might want to
  5481.      have them stored in a special drawer. You can do this by editing
  5482.      the default download paths. Most important is the `Default binary
  5483.      download path', I suggest to create a drawer called `Downloads'
  5484.      within the drawer `term' resides in. Once this is done simply type
  5485.      the name `PROGDIR:Downloads' and return to the main menu. The next
  5486.      binary file downloaded will go into the `Downloads' drawer.
  5487.  
  5488.    If you followed these steps `term' should be configured for the first
  5489. session. Save the current settings to disk now so you can always return
  5490. to this working configuration later in case the changes you made to the
  5491. current setup did not have the desired effect. You can try to fine-tune
  5492. your `term' setup now and change some of the options not covered in this
  5493. brief introduction, but please remember to keep your original
  5494. configuration file in a safe place, you will be glad you did.
  5495.  
  5496. Built-in terminal emulation
  5497. ***************************
  5498.  
  5499.    The `term' built-in terminal emulation implements the VT220 command
  5500. set with a few exceptions. There are no country specific character sets,
  5501. no down-line-loadable character sets, no user defined keys, no keyboard
  5502. language support and only ten function keys, not twenty (many of these
  5503. features are supported through the Amiga operating system). Most VT102
  5504. and VT52 commands should be supported as well, but since my
  5505. documentation on these command sets is rather incomplete I cannot be
  5506. entirely sure all the features are covered.
  5507.  
  5508.    The numeric keypad and the four cursor keys can be switched into
  5509. applications mode if requested by the remote. The four programmable
  5510. function keys (also known as PF keys) are mapped to the top row of the
  5511. numeric keypad. When in applications mode these keys will generate the
  5512. codes produced by the PF keys on a VT102 terminal. If in standard mode,
  5513. you will need to hold down the `Control' key in order to make theses
  5514. keys generate the correct PF key codes.
  5515.  
  5516.    The `Tab' and `Space' keys receive special treatment if a qualifier
  5517. key is held down when they are pressed. `Shift + Tab' will generate two
  5518. `Escape + Tab' characters. `Control + Space' generates the ASCII `NUL'
  5519. byte.
  5520.  
  5521. Text buffer
  5522. ***********
  5523.  
  5524.    The text buffer implements a service which continually stores text
  5525. displayed on `term's main screen, so the user can refer to it lateron.
  5526.  
  5527. General characteristics
  5528. =======================
  5529.  
  5530.    The size of the text buffer is managed dynamically so that for every
  5531. new line which is read new memory must be allocated. So the size of the
  5532. text buffer is limited only by the amount of the available memory. It
  5533. is recommended that the text buffer is emptied periodically to avoid
  5534. using the entire free memory.
  5535.  
  5536.    If there is insufficient memory to place a new line into the text
  5537. buffer, the first line will be deleted to make room for the new line.
  5538.  
  5539. Operation
  5540. =========
  5541.  
  5542.    The contents of the text buffer can be paged through using the keys
  5543. for moving of the cursor (`Shift + Cursor' keys moves page by page,
  5544. `Control + Cursor' key jumps to the beginning or end of the text
  5545. buffer). Additionally, the numeric keypad keys are overlaid with jump
  5546. and paging functions (corresponding to the inscriptions/graphics on the
  5547. front of the keys).
  5548.  
  5549.    There also is a pull-down menu available which is briefly described
  5550. below:
  5551.  
  5552. `Search'
  5553.      A search function is called which scans from the topmost line on
  5554.      the screen for the search text entered. If the search text is
  5555.      found it is displayed and highlighted.
  5556.  
  5557.      `term' remembers search strings entered. You can use the `Cursor
  5558.      up' and `Cursor down' keys to recall previous input.
  5559.  
  5560.      In addition to the search text there are a number of options which
  5561.      may be specified when searching:
  5562.  
  5563.     `Search forward'
  5564.           If this switch is enabled `term' search from the topmost line
  5565.           on the screen downward to the end of the buffer, otherwise it
  5566.           searches upward to the beginning of the buffer.
  5567.  
  5568.     `Ignore case'
  5569.           With this switch enabled the search does not distinguish
  5570.           between lower case and upper case characters, i.e. `TEXT' =
  5571.           `Text' = `text', etc.
  5572.  
  5573.     `Only whole words'
  5574.           If this switch is enabled, `term' will search for whole words
  5575.           only, not for parts of a word. For example, searching for
  5576.           `term' with the `Only whole words' option enabled would stop
  5577.           at the word `term', but ignore the word `terminal'.
  5578.  
  5579. `Repeat search'
  5580.      Continues the search process started with `Search'. The previously
  5581.      entered search text is carried over.
  5582.  
  5583. `Go to main screen'
  5584.      Switches to the main screen of `term'.
  5585.  
  5586. `Clear buffer'
  5587.      Clears the contents of the text buffer.
  5588.  
  5589. `Close buffer'
  5590.      Closes the text buffer screen but leaves the contents unchanged.
  5591.  
  5592. Clipboard
  5593. *********
  5594.  
  5595.    Cut & paste functions are available on the main screen, the buffer
  5596. screen and the review buffer. Here is how to use them:
  5597.  
  5598. `Buffer screen'
  5599.      Use the mouse to point to the first character you wish to send to
  5600.      the clipboard, hold down the select button, drag the mouse to the
  5601.      last character you wish to copy and release the button. The text
  5602.      marked will be transferred to the clipboard.
  5603.  
  5604.      Holding down the `Control' key while clicking on a character will
  5605.      feed the single character into the input stream, it will not be
  5606.      buffered in the clipboard.
  5607.  
  5608. `Main screen'
  5609.      Use the mouse to point to the first character you wish to send to
  5610.      the clipboard, hold down the select button, drag the mouse to the
  5611.      last character you wish to select and release the button. Select
  5612.      the `Copy' menu item (see Edit) to transfer the text to the
  5613.      clipboard.  Instead of dragging the mouse you may also
  5614.      double-click on a single word to select it.
  5615.  
  5616.      Holding down the `Control' key while clicking on a character will
  5617.      feed the single character into the input stream, it will not be
  5618.      buffered in the clipboard.
  5619.  
  5620. `Review buffer'
  5621.      Use the mouse to point to the first character you wish to send to
  5622.      the clipboard, hold down the select button, drag the mouse to the
  5623.      last character you wish to select and release the button. Press
  5624.      `Amiga + C' to copy the selected text to the clipboard.
  5625.  
  5626.    To paste the clipboard contents, i.e. feed them into the terminal
  5627. input stream, either select the `Paste' menu item (see Edit) or press
  5628. `Amiga + V'. In order to send the clipboard contents along with a
  5629. `Paste prefix' and `Paste suffix' hold down any `Shift' key when
  5630. selecting the `Paste' menu entry or when selecting text with the mouse
  5631. (this works both with the main screen and the text buffer screen).
  5632.  
  5633.    Hold down one of the `Alt' keys and press the left mouse button to
  5634. make `term' emit a number of cursor move sequences which will position
  5635. the on-screen cursor at the spot where you clicked the mouse.
  5636.  
  5637.    In standard text gadgets a solution had to be found to preserve the
  5638. line editing functions while still supporting menu shortcuts. To undo
  5639. any changes made press `Amiga + Q', to clear the text gadgets press
  5640. `Amiga + X'. Menus associated with the shortcuts `Amiga + Q/X' are
  5641. called by holding down any `Shift' key along with the `Amiga' keys
  5642. (i.e. `Shift + Amiga + Q' will select the `Quit' menu item if
  5643. available).
  5644.  
  5645. Command sequences
  5646. *****************
  5647.  
  5648.    Each text sent directly to the modem is a command sequence. This
  5649. includes telephone numbers, modem initialisation strings, function key
  5650. assignments, etc. In addition to the normal text strings various other
  5651. commands are supported which will be described in the following section.
  5652.  
  5653. Backslash
  5654. =========
  5655.  
  5656. `\'
  5657.      Generates a single backslash.
  5658.  
  5659. `\0'
  5660.      Resets the text pacing mode (see Clipboard panel) to the settings
  5661.      defaults. Any changes of the text pacing mode affect only the line
  5662.      to be sent. The next following line will be sent using the default
  5663.      text pacing mode.
  5664.  
  5665. `\1'
  5666.      Sets the text pacing mode to `Direct'.
  5667.  
  5668. `\2'
  5669.      Sets the text pacing mode to `Wait for echo'.
  5670.  
  5671. `\3'
  5672.      Sets the text pacing mode to `Wait for any echo'.
  5673.  
  5674. `\4'
  5675.      Sets the text pacing mode to `Wait for line prompt'.
  5676.  
  5677. `\5'
  5678.      Sets the text pacing mode to `Character/line delay'.
  5679.  
  5680. `\6'
  5681.      Sets the text pacing mode to `Keyboard delay'.
  5682.  
  5683. `\a'
  5684.      Executes an ARexx command (all text to follow this character).
  5685.  
  5686. `\b'
  5687.      Generates a backspace (deletes the character to the left of the
  5688.      cursor).
  5689.  
  5690. `\c'
  5691.      Calls a main menu entry, the menu entry to be called is determined
  5692.      by the argument to follow; this is either a six digit number
  5693.      (example: `\c 010203' would call subitem 1, item 2, menu 3) or the
  5694.      name of the menu entry enclosed in single quotes to call (example:
  5695.      `\c 'about'' would call the `About...' menu entry, the search is
  5696.      case-insensitive and only compares the characters given).
  5697.  
  5698. `\d'
  5699.      Executes an AmigaDOS command (all text to follow this character).
  5700.  
  5701. `\e'
  5702.      Generates the escape character (ASCII code 27).
  5703.  
  5704. `\f'
  5705.      Generates a form feed (skip to beginning of the next page or clear
  5706.      the screen).
  5707.  
  5708. `\g'
  5709.      Places the text to follow this character in the clipboard.
  5710.  
  5711. `\h'
  5712.      Appends the text to follow this character to the current clipboard
  5713.      contents.
  5714.  
  5715. `\i'
  5716.      Feeds the contents of the clipboard into the input stream.
  5717.  
  5718. `\n'
  5719.      Generates a line feed.
  5720.  
  5721. `\p'
  5722.      Feeds the password of the currently active telephonebook entry
  5723.      into the input stream. *The password is automatically cleared for
  5724.      security reasons when the connection is lost.*
  5725.  
  5726. `\r'
  5727.      Generates a carriage return.
  5728.  
  5729. `\t'
  5730.      Generates a tab jump.
  5731.  
  5732. `\u'
  5733.      Similar to the `\p' command, the `\u' command will feed the
  5734.      current user name into the input stream.
  5735.  
  5736. `\w'
  5737.      Depending on how the `Dial mode' switch is set in the modem
  5738.      settings, this command either produces `P' for pulse dialing or
  5739.      `T' for touch tone dialing.
  5740.  
  5741. `\x'
  5742.      Generates a break signal (as with the `Send break' menu entry).
  5743.  
  5744. `\^'
  5745.      Generates a caret character.
  5746.  
  5747. `\~'
  5748.      Generates a tilde character.
  5749.  
  5750. `\*'
  5751.      The code to follow the asterisk determines the character to
  5752.      produce.  This can be any three digit number or a symbolic name
  5753.      from the following list (1):
  5754.  
  5755.      `NUL', `SOH', `STX', `ETX', `EOT', `ENQ', `ACK', `BEL', `BS',
  5756.      `HT', `LF', `VT', `FF', `CR', `SO', `SI', `DLE', `DC1', `DC2',
  5757.      `DC3', `DC4', `NAK', `SYN', `ETB', `CAN', `EM', `SUB', `ESC',
  5758.      `FS', `GS', `RS', `US', `SP', `DEL', `SS2', `SS3', `DCS', `CSI',
  5759.      `ST', `OSC', `PM', `APC', `NBS' and `SHY'
  5760.  
  5761.    If none of the mentioned combinations is recognized the character
  5762. which follows the `\' will be fed into the input stream without any
  5763. changes.
  5764.  
  5765.    ---------- Footnotes ----------
  5766.  
  5767.    (1)  `EOU' may be implemented in a future release
  5768.  
  5769. Caret
  5770. =====
  5771.  
  5772.    This character is used to change the following character to a
  5773. `control character'. So the sequence `^J' will become a Line feed and
  5774. `^I' becomes a tab jump. The character which follows the `^' has to be
  5775. located between `@' and `[', otherwise it is fed into the input stream
  5776. without changes.
  5777.  
  5778. Tilde
  5779. =====
  5780.  
  5781.    This character causes the program to pause for exactly half a second
  5782. before it continues to process the following commands.
  5783.  
  5784. Fast! macros
  5785. ************
  5786.  
  5787.    In implementation and design the fast! macros are closely related to
  5788. the function key macros (see Function key panel). If invoked by
  5789. selecting the corresponding menu entry, a window will open on the right
  5790. hand side of the screen sporting a scrollable list of macros (the
  5791. contents of this list can be edited using the fast! macro panel).  When
  5792. a list entry is selected, the associated command sequence (see Command
  5793. sequences) will be executed.
  5794.  
  5795.    By using the fast! macros it is theoretically possible to control a
  5796. BBS just by mouse, provided that you have the approriate macros in your
  5797. fast! macro list.
  5798.  
  5799.    The fast! macro panel can be resized and acts just like the main
  5800. `term' window:  menu items can be selected and characters entered are
  5801. sent to the serial driver.
  5802.  
  5803. Packet window
  5804. *************
  5805.  
  5806.    In this window a line can be edited before it is sent. All the usual
  5807. editing functions known from standard input fields are available
  5808. (`Shift + cursor left/right' jumps to the start/end of the line).
  5809.  
  5810.    Additionally, some extended functions exist which are performed by
  5811. pressing a cursor key together with the `Shift' or `Control' key:
  5812.  
  5813. `Control + Cursor left'
  5814.      Jumps to the next word.
  5815.  
  5816. `Control + Cursor right'
  5817.      Jumps to the previous word.
  5818.  
  5819. `Cursor up'
  5820.      Shows the last entered command in the input line.
  5821.  
  5822. `Shift + Cursor up'
  5823.      Shows the very first command entered so far.
  5824.  
  5825. `Cursor down'
  5826.      Shows the next entered command (if you moved back for some
  5827.      commands before).
  5828.  
  5829. `Shift + Cursor down'
  5830.      Shows the very last command entered so far.
  5831.  
  5832.    This text gadget has a buffer where all previously entered commands
  5833. are stored (`Command history'). You can page through this buffer, load
  5834. and save it and individual lines can be recalled. As with the text
  5835. buffer this buffer is managed dynamically. The same memory restrictions
  5836. that apply to the text buffer are valid for this buffer.
  5837.  
  5838.    The input line also has a menu which offers the following functions:
  5839.  
  5840. `Load history'
  5841.      Loads the contents of the input line buffer from a file. Each
  5842.      stored line in this file can be recalled and sent.
  5843.  
  5844. `Save history as...'
  5845.      Saves the contents of the input line buffer to a file.
  5846.  
  5847. `Clear history'
  5848.      Simply releases all previously stored commands and the memory used
  5849.      by them.
  5850.  
  5851. `Other window'
  5852.      Switches to the main screen of `term'.
  5853.  
  5854. `Show output'
  5855.      If not enabled, this causes the input line not to be echoed in the
  5856.      terminal window.
  5857.  
  5858. `Quit'
  5859.      Closes the window (corresponds to clicking the close gadget of the
  5860.      window).
  5861.  
  5862.    *Every character entered into this window is shown immediately so
  5863. that those things where it is better that they should not appear on the
  5864. screen (like passwords for a mailbox) should be entered in another way.*
  5865.  
  5866.    The contents of every input line are interpreted as a command
  5867. sequence and therefore can also contain control characters.
  5868.  
  5869.    If a line taken from the input buffer is sent without change it is
  5870. *not* stored in the buffer again (`true history' such as known from
  5871. `ConMan').
  5872.  
  5873.    The contents of the input buffer are cleared automatically after the
  5874. window is closed. *Under no circumstances are the contents maintained
  5875. until the next call!*
  5876.  
  5877.    Provided that the packet window is large enough, a list to contain
  5878. the command line history will be displayed.
  5879.  
  5880. Chat line
  5881. *********
  5882.  
  5883.    The chat line is roughly functionally equivalent to the packet window
  5884. (see Packet window). However, there is no special pull-down menu and no
  5885. option to save or load the command history. Unlike the packet window
  5886. the command history is kept between invocations.
  5887.  
  5888.    The chat line is, as the name says, a text entry field which allows
  5889. one single line of text to be entered. Except for the optical
  5890. appearance and the handling of control characters (the text entry field
  5891. appears as a single line above the status line, it's also a tad smaller
  5892. than the packet window) it is virtually identical in handling with the
  5893. packet window. The only exception is the special key combination to use
  5894. when clearing the entire past command history.  To clear the history,
  5895. hold down either `Amiga' key and then press either the `Del' or the
  5896. `Backspace' key.
  5897.  
  5898.    The chat line always passes control characters, such as `Control + C'
  5899. and `Tab' straight through to the modem.
  5900.  
  5901. Script recording
  5902. ****************
  5903.  
  5904.    `term' offers a feature called `Script recording' which lets you
  5905. record incoming data sent by a BBS or a remote host and your response
  5906. to it, i.e. the text you typed, such as login name and password. The
  5907. recorded data can then be saved to an ARexx script file which can be
  5908. used as an auto-login script.  In order to record a script you can
  5909. either use the dialing panel button labeled `Start recording on
  5910. connection' or the menu item `Record'.
  5911.  
  5912.    Once `term' is recording terminal output and your input the status
  5913. display will show `Recording' or `Rec.line', depending on the text
  5914. entry mode. By default `term' will only record single keystrokes, which
  5915. makes it difficult to enter whole words. If you want `term' to remember
  5916. the entire line of text you are about to enter either use the `Record
  5917. line' menu item or press the `shift+return' key combination: the status
  5918. will change to `Rec.line'. To return to keystroke recording just press
  5919. the `return' key or select the `Record line' menu item/press
  5920. `shift+return' again.
  5921.  
  5922.    `term' only remembers the last ten characters sent and a maximum of
  5923. 256 characters you can enter per line. If you enter more than this
  5924. number of characters older keystrokes will be discarded.
  5925.  
  5926.    When you are finished recording the script select the `Record line'
  5927. menu item. A file requester will ask you for the file name to save the
  5928. script under. If the file is successfully saved you may be asked whether
  5929. you want the script file to be used as a login script for the currently
  5930. active phonebook entry.
  5931.  
  5932.    *To make sure that the script associated with the phonebook entry
  5933. will be called the next time you dial it the phonebook file must be
  5934. saved to disk before you quit `term'.*
  5935.  
  5936.    The script file generated will consist of ARexx commands `term'
  5937. understands, mostly `TIMEOUT', `WAIT' and `SEND'. The text to be waited
  5938. for and to be sent is given in standard `term' command sequence
  5939. notation. For more information consult the chapter entitled Command
  5940. sequences.  The `term' ARexx interface documentation provides the
  5941. necessary background to explain how the script commands work, it should
  5942. also give you hints how to customize the recorded scripts.
  5943.  
  5944.    *Caution:* scripts recorded by `term' usually need additional
  5945. editing, don't expect a script to work right away.  You may want to
  5946. change the timeout values, remove extra characters and input.
  5947.  
  5948. term and Emplant
  5949. ****************
  5950.  
  5951.    You need to keep a few things in mind before you actually try to use
  5952. `term' with Emplant, the Apple Macintosh emulation and the on-board
  5953. serial ports:
  5954.  
  5955.   1. Both the emulation and `term' are very demanding programs in terms
  5956.      of memory usage. The Macintosh emulation will allocate a fixed
  5957.      memory area for itself which normally should be as large as
  5958.      possible. `term' has to use the amount of memory that remains,
  5959.      which may not be much. It is recommended that at least 3-4 MBytes
  5960.      of memory should be available when you start `term'.  Although the
  5961.      program will show an error message if it cannot allocate enough
  5962.      memory the external modules (terminal emulation libraries, file
  5963.      transfer libraries, serial device driver, etc.) may not work
  5964.      properly under low memory conditions and thus can cause software
  5965.      failures. You should reduce the sizes of the many memory buffers
  5966.      `term' uses to perform its functions, such as transfering files
  5967.      and capturing text. For example, the text buffer will keep growing
  5968.      until all available memory is exhausted unless you set a maximum
  5969.      limit for its size (see Capture panel).
  5970.  
  5971.   2. `term' can share the device driver selected for the I/O ports with
  5972.      Emplant. For example, if you select `serial.device' as the driver
  5973.      to use for `Port A' Emplant will open the driver in shared mode.
  5974.      In `term' you would select the `Shared access' switch in the
  5975.      serial settings (see Serial panel). When both programs are up and
  5976.      running you must make sure that only one program at a time will
  5977.      access the serial device driver, or data may be lost. For example,
  5978.      if you have `ZTerm' and `term' running and wish to use `ZTerm' for
  5979.      communications you *must* make `term' release the serial device
  5980.      driver (use the `Modem' menu item `Release serial device' for this
  5981.      purpose). Likewise, if you wish to use `term' instead of `ZTerm'
  5982.      or some other terminal program on the Macintosh side, make sure
  5983.      you quit the Macintosh terminal program first.
  5984.  
  5985.      Take care, LocalTalk can have a negative effect on the serial data
  5986.      transfer performance.
  5987.  
  5988.   3. If you connect one of the Emplant serial ports to your modem you
  5989.      should know whether the connector pins that are used for 7 wire
  5990.      hardware handshaking (RTS/CTS handshaking) are properly connected
  5991.      or not. Some cables that are sold for use with Hayes modems or the
  5992.      Apple ImageWriter do not have the necessary pins connected. If you
  5993.      wish to use the RTS/CTS handshaking protocol (see Serial panel),
  5994.      set the handshaking mode to `RTS/CTS (Check DSR)'.  This insures
  5995.      that `term' will run properly even if your cable cannot be used
  5996.      for RTS/CTS handshaking. Your Amiga may lock up if the cable does
  5997.      not support RTS/CTS handshaking and you have `RTS/CTS' selected as
  5998.      the handshaking protocol.
  5999.  
  6000.   4. It is unwise to use `empser.device' while the Macintosh emulation
  6001.      is running. Since the Macintosh drivers are unaware of the Amiga
  6002.      side trying to access the serial port hardware conflicts are not
  6003.      to be avoided. Either use `term' with `empser.device' or run the
  6004.      Macintosh emulation, you cannot do both at the same time.
  6005.  
  6006. term and SLIP
  6007. *************
  6008.  
  6009.    If you are brave enough to use `term' to dial into your SLIP account,
  6010. you should make sure that your modem does not hang up when you leave
  6011. `term' and hand control over to your SLIP software. Typically, closing
  6012. the serial device driver causes the DTR signal to drop which some modems
  6013. interprete as an immediate command to abort the connection. This signal
  6014. is automatically dropped when `term' is terminated.
  6015.  
  6016.    To avoid this problem, consult your modem manual for information on
  6017. a command that controls how the modem reacts when the DTR signal is
  6018. dropped. For a ZyXEL modem this would be `AT&D0'. Put the command
  6019. `AT&D0\r' into the modem init command field (see Modem panel) of the
  6020. phonebook entry you use to dial into your SLIP account.
  6021.  
  6022. Environment variables
  6023. *********************
  6024.  
  6025.    Information which is to be available the next time the program is
  6026. run is placed as AmigaDOS variables in the directories `ENV:' and
  6027. `ENVARC:' by `term'.
  6028.  
  6029.    The variables used by `term' can be used and manipulated by other
  6030. programs transparently. In detail these variables are:
  6031.  
  6032. `TERMCONFIGPATH'
  6033.      The name of the drawer in which all information used by `term' is
  6034.      placed (standard configuration, phonebook, etc.). The default
  6035.      settings path name is `TERM:config'.
  6036.  
  6037. `TERMWINDOW'
  6038.      The window definition which can also be entered in the program via
  6039.      the menu item Settings.
  6040.  
  6041. `xpr...'
  6042.      The standard settings used for the corresponding transfer protocol
  6043.      (`xprzmodem', `xprkermit', etc.).
  6044.  
  6045. `xem...'
  6046.      The standard settings used for the corresponding external terminal
  6047.      emulation library (`xemvt340', `xemascii', etc.).
  6048.  
  6049. PGP key
  6050. *******
  6051.  
  6052.    Below you will find my signed public key. Save it to a disk file and
  6053. enter `PGP <file name>' to decode it. This will produce a file called
  6054. `public_key'. To add my key to your PGP keyring now enter `PGP -ka
  6055. public_key' and follow the instructions on the screen. To verify my
  6056. signature, now enter `PGP <file name>' again. It's probably pretty
  6057. paranoid to rely upon PGP signatures and keys, but then again you might
  6058. want to have a somewhat unambiguous proof that the distribution
  6059. archives you have downloaded are intact.  Security can still be
  6060. compromised, if you don't trust the key below you can still contact me
  6061. to ask for an official key.
  6062.  
  6063. -----BEGIN PGP MESSAGE-----
  6064. Version: 2.3a.2
  6065.  
  6066. owHrZAhlYmXQEzvfldcZOadb3WIiI+OGm4y/2ZdpeDIxcR1o4V/elrPHvuTZjnbV
  6067. f54d6g++Trl1qJz/35uNVg33GSfvfzH7lnVo/ZWHVwsuOTq+TDSZsnXTx5eGFyzW
  6068. MkolcRWUJuVkJsdnp1YyAIEuCDi5unv6KQS4BygEhDr5eDoreLtGKjj5+Dt7g6W5
  6069. wlKLijPz86wUjPSME/WMuLhyA538HDMrnSzMIh0dHV2dHX0yywxCSkNSvQKqnHKy
  6070. vHIynUvK8lyKU/XLsyJNvFKrynJLfLKN07RDk6NM0wrDuNK9QyO8MgIjw4NMzS2M
  6071. 03MKCx1DHNOLfPxNI72T8nOi8jyL8/y9XB2dgtwNfFwtiyPDI9MjgXSyUVipV6WT
  6072. M1dkhJdBontYsadLRVmSh19OUrZTVZJxWGWkUVhlarBpfmS4SWmUe6g2l61prkEq
  6073. F9gfrn4ueDwJAA==
  6074. =kKr7
  6075. -----END PGP MESSAGE-----
  6076.  
  6077.    PGP-encoded mail is not welcome at my internet site!
  6078.  
  6079. Revision history
  6080. ****************
  6081.  
  6082. Changes introduced with v4.6:
  6083. *****************************
  6084.  
  6085.    * Adding the first entry to an empty phonebook did not make the list
  6086.      available, it would stay ghosted.
  6087.  
  6088.    * The transfer window accidentally did not receive any window refresh
  6089.      events, causing it to stay more or less blank when
  6090.      zooming/unzooming it.
  6091.  
  6092.    * Removing phonebook entries from existing groups through the "Group"
  6093.      feature did not move them, it merely changed the name of the group.
  6094.  
  6095.    * Ghosting colours as used by the gtlayout.library created tapedeck
  6096.      and default buttons were "wrong" in a sort of way; the UI style
  6097.      guide suggests to use the shadow pen to draw the ghosting patterns,
  6098.      but there was still some experimental code in the library to use
  6099.      the background pen, really "ghosting" the gadgets.
  6100.  
  6101.    * Finally got the font style rendering bits right with
  6102.      gtlayout.library (and also saved a few bytes on the way).
  6103.  
  6104.    * A few changes in the font size setup code used by gtlayout.library
  6105.      and the status line box layout process now allow fonts with broken
  6106.      kerning and width table data to be used, such as the Scala FuturaB
  6107.      font which has trash in place of the \ and | glyphs. Caution
  6108.      please, although the layout routines now allow the screen layout
  6109.      to proceed in an orderly fashion, Intuition may fail to render
  6110.      pull-down menus correctly.
  6111.  
  6112.    * Horizontal sliders (LEVEL_KIND) as used by `term' now render much
  6113.      smoother and faster.
  6114.  
  6115.    * Stripped grouping frames from windows in which only one single
  6116.      group was displayed.
  6117.  
  6118.    * Changed the 16 colour window backfill code back to use RectFill()
  6119.      rather than the Saturday Night Special BitMap. No longer crashes
  6120.      CPUBlit or gets into trouble with CyberGraphX.
  6121.  
  6122.    * Stripped some more old and dead code from the phone panel.
  6123.  
  6124.    * Tagging entries in the phonepanel moved the list display around,
  6125.      which was both nasty and not necessarily a good thing to do
  6126.      [Andreas Kirchwitz].
  6127.  
  6128.    * Fixed the "Copy" crash & burn bug in the phone panel (how comes
  6129.      I'm feeling so stupid?).
  6130.  
  6131.    * Adding a new phonebook entry did not update all the gadgets that
  6132.      should get updated.
  6133.  
  6134.    * All-new notification requester, smaller & more powerful. It's a
  6135.      shame it only pops up when running `term' for the first time or
  6136.      when upgrading from an older release.
  6137.  
  6138.    * Removed all "Default" button code from the settings editors, the
  6139.      new phonebook editing scheme made these buttons redundant anyway.
  6140.  
  6141.    * In the phonebook edit window, the edit buttons are no longer
  6142.      ghosted if the checkboxes next to them are disabled. This is to
  6143.      allow for browsing the settings without having to enable the
  6144.      checkboxes. The functionality of the checkboxes however is still
  6145.      the same. Please note that selecting "Use" will keep the settings
  6146.      displayed and cause the checkbox to get enabled.  Selecting
  6147.      "Cancel" will leave the checkbox state untouched.
  6148.  
  6149.    * Shortened some more tab labels, although it didn't really improve
  6150.      things much.
  6151.  
  6152.    * Changing the settings of any XPR protocol through the transfer
  6153.      protocol editor could get you into real trouble, code was
  6154.      commented out that should have been there but wasn't.
  6155.  
  6156.    * The XEM interface was still using the `new' code that eventually
  6157.      was replaced by the v4.3 xpr_sread code.
  6158.  
  6159.    * In the phonebook, if no entry is selected hitting "Toggle" or
  6160.      "All" will make the first list entry displayed the selected entry
  6161.      [Russell LeBar].
  6162.  
  6163.    * The phonebook "Toggle" button never got enabled when the window
  6164.      was opened.
  6165.  
  6166.    * Moved up to the v4.4 style xpr_sread code, also caught one case in
  6167.      which XProtocolHostMon() may have trashed its buffer.
  6168.  
  6169.    * In groups, the phonebook sort function did not really sort the
  6170.      contents, it just mucked with the visible list; essentially, when
  6171.      closing the phonebook after a sort operation and reopening it
  6172.      again the list order would not appear to have changed. There also
  6173.      was a nasty side effect in that after performing a sort operation
  6174.      the list nodes would point to the wrong phonebook entries ("Your
  6175.      guide to trashing the phonebook in 3 ez pieces") [Marius
  6176.      Sundbakken].
  6177.  
  6178.    * The size of vertical separator bars as used by gtlayout.library is
  6179.      now adapted to the display aspect ratio [Marius Sundbakken].
  6180.  
  6181.    * Misc housekeeping changes.
  6182.  
  6183.    * The rates/date/time/etc. editors which get opened by the phonebook
  6184.      settings editor now come up properly centered over the window that
  6185.      brought them up.
  6186.  
  6187.    * Massive space optimizations in gtlayout.library, the 68k version is
  6188.      once again smaller than 100K, actually it's even smaller than the
  6189.      optimized 030 library that should have shipped with `term' v4.5.
  6190.  
  6191.    * The asl requester centering code was getting into trouble as the
  6192.      tag array holding the position data was not terminated.
  6193.  
  6194.    * First attempt at getting rid of unused program text. I do not know
  6195.      exactly if I managed to zap them all, but I caught most of them.
  6196.      If you spot a label/text that consists of a single dot only (".")
  6197.      please let me know and tell me where you found it.
  6198.  
  6199.    * Moved the "Text buffer services" page contents in the capture
  6200.      panel to the third page [Russell LeBar].
  6201.  
  6202.    * If the speech synthesizer is not available, the speech settings
  6203.      menu item is no longer appears.
  6204.  
  6205.    * Unified the screen mode selection code used by the screen and
  6206.      capture settings editors.
  6207.  
  6208.    * Small fixes to the custom requester code, it no longer uses
  6209.      hardcoded system gadget sizes.
  6210.  
  6211.    * The rates editor could come up with an empty list if the checkbox
  6212.      next to the rates button was not ticked.
  6213.  
  6214.    * gtlayout.library font fallback didn't fall for default and
  6215.      multiline buttons.
  6216.  
  6217.    * The tab gadget tags now have rounded caps. I finally settled with
  6218.      the first two octants of the Bresenham circle drawing algorithm.
  6219.      Essentially, this makes it difficult to create a
  6220.      resolution-adaptive arc. The `shoulders' of each tab are too
  6221.      small, especially in low resolutions, to create edges that look
  6222.      sufficiently rounded. Consequently, the arc rendered is always
  6223.      based upon a square aspect ratio, but beefed up a bit to look good
  6224.      with an 1:2 aspect ratio.
  6225.  
  6226.    * Replaced the last remaining hardware dependant code with different
  6227.      stuff: the status display code could drop into creating a user
  6228.      copper list and attaching it to the screen for the purposes of the
  6229.      providing a visual bell signal.  It now simply loads and restores
  6230.      the colour palette.
  6231.  
  6232.    * The single character entry was using the wrong colour when doing
  6233.      the first text rendering pass [Göran Åberg].
  6234.  
  6235.    * The transfer upload queue now uses the default binary upload path
  6236.      as its home directory [Göran Åberg].
  6237.  
  6238.    * The area code panel was not allowing you to save the list after
  6239.      loading a new list [Göran Åberg].
  6240.  
  6241.    * The area code panel, fast! macro panel and the trap panel would
  6242.      get into big trouble when removing the last entry from the list.
  6243.      [Göran Åberg].
  6244.  
  6245.    * For similar reasons the phonebook "Remove" function was broken.
  6246.  
  6247.    * Shortened the labels in the upload/download window [Bob Maple].
  6248.  
  6249.    * The same bug that used to wreck the phonebook "Copy" code was
  6250.      having a good time in the "Remove" code. It no longer does.
  6251.  
  6252.    * Shortened the labels in the upload/download window some more [Bob
  6253.      Maple].
  6254.  
  6255.    * Moved the columns/lines settings from the terminal settings page
  6256.      #2 to page #3.
  6257.  
  6258.    * The hair lines between single tabs in tab gadgets are now
  6259.      resolution adaptive.
  6260.  
  6261.    * The terminal settings editor now also sports an "BBS ANSI
  6262.      compliant" button.
  6263.  
  6264.    * Moved the pages with the "BBS ANSI compliant" buttons as featured
  6265.      in the emulation and terminal settings to the first pages.
  6266.  
  6267.    * The "Toggle" button could get the highlighting order of phonebook
  6268.      entries dead wrong [Russell Woodford].
  6269.  
  6270.    * Part of the colour palette loading code was so screwed you could
  6271.      have hung several chandeliers to it.
  6272.  
  6273.    * The fix I put in to avoid having XProtocolHostMon trash its buffer
  6274.      turned out to be doing not much (read: nada). Fixed.
  6275.  
  6276.    * Rewrote all the code that used the one single open timer,
  6277.      including all instances in which TR_GETSYSTIME was invoked rather
  6278.      than calling GetSysTime() directly.
  6279.  
  6280.    * Finally (!) arrived at a safe, slick, transparent and crystal
  6281.      clear xpr_read() implementation. If this one still breaks
  6282.      serial.device and friends I'm really going to cry...
  6283.  
  6284.    * Cleared out more old and dead code.
  6285.  
  6286.    * Changed the order of pages in the path and protocol settings
  6287.      editors, they now read binary, text, ascii. In the serial settings
  6288.      editor, moved the device driver page to #2.
  6289.  
  6290.    * Checked all the places in which file requesters were opened and
  6291.      made sure that whenever they are associated with actions which
  6292.      will cause files to be written to, they will come up with the
  6293.      "Save" mode set.
  6294.  
  6295.    * No longer limits font sizes to 24 points.
  6296.  
  6297.    * The picker glyph size is now adapted to the screen resolution.
  6298.  
  6299.    * Finally went through the great renaming, none of the program
  6300.      source modules bears the name "term" in its name any more. I also
  6301.      went through the prototypes and all the header files with a fine
  6302.      tooth comb. `term' now compiles much faster, and it is using
  6303.      regargs parameters throughout the program.
  6304.  
  6305.    * The next step in trying to fix the "stuck download" problem; the
  6306.      file transfer window is now opened on the schedule of another
  6307.      process, so it doesn't block the file transfer progress.
  6308.  
  6309.    * The cursor key settings editor consistently looked at the wrong
  6310.      buffer. "Use" never really worked.
  6311.  
  6312.    * Cleared out even more dead and unused code & data.
  6313.  
  6314.    * Corrected a bunch of callback-routines which needed their data on
  6315.      the stack rather than in registers.
  6316.  
  6317.    * Reduced stack size requirements for subprocess creation to
  6318.      reasonable amounts, which in this case means a maximum of 8000
  6319.      bytes per process.
  6320.  
  6321.    * Unified the most frequently used process creation procedures, the
  6322.      whole creation business now runs through one single routine.
  6323.  
  6324.    * Now properly remembers the position of the review buffer window
  6325.      instead of always using default values.
  6326.  
  6327.    * Now properly sets its own program name when getting run from
  6328.      Workbench [Petri Nordlund].
  6329.  
  6330.    * No longer tries to pull input from the transfer window MsgPort
  6331.      until the window is ready and open. This avoids responses to
  6332.      refresh events until the window is ready for them.
  6333.  
  6334.    * Put in some experimental code to delay trap scanning until after
  6335.      control sequences and such have been filtered out. I'm not sure if
  6336.      I should make this a configurable feature.
  6337.  
  6338.    * The serial settings editor was not allowing you to change the
  6339.      buffer size or the quantum value [Peter Popanda].
  6340.  
  6341.    * Similar effects could cause trouble with the modem settings.
  6342.  
  6343.    * Big phonebook code cleanup, things should still work, though.
  6344.  
  6345.    * The experimental trap filter code was not doing things right, it
  6346.      did whatever it wanted to do, but could end up rolling the marbles
  6347.      on the schedule of the emulation task which was not allowed to
  6348.      play with the serial port and his friends...
  6349.  
  6350.    * The XPR code could miss single xpr_update() events, simply because
  6351.      the display window was not yet open. It now tries to buffer the
  6352.      data it displays until the window is open and ready. The next
  6353.      following call to xpr_update() will then do the work necessary to
  6354.      get the cached data displayed.
  6355.  
  6356.    * Simplified the final program cleanup code a lot, after all there
  6357.      is memory tracking built into the pools. Also, a lot was gained by
  6358.      taking advantage of the fact that many operating system routines
  6359.      are tolerant to NULL parameters.
  6360.  
  6361.    * Cleaned up the header files a bit.
  6362.  
  6363.    * The incrementer arrows are now resolution adaptive. I also polished
  6364.      the picker images a bit.
  6365.  
  6366.    * Removed all absolute address references to data items. As the data
  6367.      hunk size revealed, the amount of static and bss data compiled with
  6368.      the program is well below the magic 64K boundary (24K so far). This
  6369.      brought the total gain in program size compared to v4.5 to a
  6370.      stunning 36K...
  6371.  
  6372.    * Removed the silly "locale library not installed correctly"
  6373.      requester, as well as the busy mouse pointer code which was easily
  6374.      replaced with gtlayout.library/LT_Lock/UnlockWindow.
  6375.  
  6376.    * More space optimizations in gtlayout.library, which is now more
  6377.      than 4K smaller than the release that shipped with v4.5
  6378.  
  6379.    * Recompiled `term' and gtlayout.library with SAS/C 6.56.
  6380.  
  6381.    * A variable was being shadowed in the text buffer screen creation
  6382.      code which could lead to all kinds of funny effects, including the
  6383.      window opening being 0 pixels tall. I guess that this finally fixes
  6384.      the last possible buffer crash problem.
  6385.  
  6386.    * When clearing the text/review buffer, the buffer percent displays
  6387.      are also updated.
  6388.  
  6389.    * Fixed a very nasty bug in the user interface library code that
  6390.      would draw the text boxes in the about window and frequently crash
  6391.      the machine with an invalid RectFill() call. I also managed to save
  6392.      even more space on the way.
  6393.  
  6394.    * `term' now requires gtlayout.library v26 to run.
  6395.  
  6396.    * On a heavily loaded system (speaking of DMA), the blitter could run
  6397.      wild, trashing the display while the phonebook was being displayed.
  6398.      I came up with a workaround which involves making the phonebook
  6399.      window simple refresh [Russell LeBar].
  6400.  
  6401.    * Ran another test on the A500+, `term' now even fits into 1.5 MBytes
  6402.      of memory and will do file transfers at 19,200 baud without
  6403.      complaining.
  6404.  
  6405.    * On very slow computers it can take several ten seconds for the
  6406.      transfer window to open. If a transfer error occured while the
  6407.      window was still closed `term' would crash, it no longer does.
  6408.  
  6409.    * More fixes for very slow computers. Still, in very unlucky cases a
  6410.      download can come to a grinding halt and tilt itself along with
  6411.      the operating system over the edge. I have no solution for this
  6412.      stuff right now, I guess it's just a bad habit to keep such an
  6413.      utterly slow computer around (tested with the A500+ in 16 colours,
  6414.      non-interlaced; don't do it).
  6415.  
  6416.    * Fixed an Enforcer hit in the gtlayout.library menu creation code I
  6417.      had overlooked. Feeling adventurous, I optimized the object layout
  6418.      code and ran it through the optimizer.
  6419.  
  6420.    * Made the phonebook use a simple refresh window to avoid weird
  6421.      blitter effects [Russell LeBar].
  6422.  
  6423.    * Small fixes to the gtlayout.library keyboard shortcut picking code
  6424.      [Kai Iske].
  6425.  
  6426.    * The phonebook could present you the hardcoded settings defaults
  6427.      rather than copies of the global configuration [Martin
  6428.      Steigerwald].
  6429.  
  6430.    * More fun with gtlayout.library, aligned most variables to long
  6431.      word addresses, optimized bits & pieces and replaced the
  6432.      horizontal and vertical line drawing code with calls to RectFill().
  6433.      Lots of changes here, have fun.
  6434.  
  6435.    * The listview ghosting code was rendering into the main terminal
  6436.      window, not into the listview, oops.
  6437.  
  6438.    * No longer displays the OwnDevUnit settings page if
  6439.      OwnDevUnit.library is not around.
  6440.  
  6441.    * The new gtlayout.library had *some* rendering problems when running
  6442.      under Kickstart 2.04, or should I say that Kickstart 2.04 had some
  6443.      rendering problems with gtlayout.library? Area fill patterns did
  6444.      not get cleared for RastPorts passed to the rendering code,
  6445.      ghosting did make a bit hit.
  6446.  
  6447.    * I guess nobody noticed this yet, but the popup gadget could lose
  6448.      refresh events after cleaning up the popup menu.
  6449.  
  6450.    * The string/command `term' sends to the remote after invoking the
  6451.      "Wait..." command is now configurable in the misc settings
  6452.      [Russell LeBar].
  6453.  
  6454.    * Just found out that the popup gadget doesn't work so well under
  6455.      Kickstart v2.04, so it's back to cycle gadgets then...
  6456.  
  6457.    * Threw in some binary search code for the locale string lookup
  6458.      procedure.
  6459.  
  6460.    * Some of the user interface layout fallback routines could kick in
  6461.      too late, i.e. after the window was already open.
  6462.  
  6463.    * The transfer performance window now opens on the same screen the
  6464.      transfer window opens.
  6465.  
  6466.    * The "Duplex" switch in the serial settings now reads "Local echo".
  6467.  
  6468.    * `term' could still crash upon exit, this should be fixed now.
  6469.  
  6470.    * Had to return to using a smart refresh phonebook window due to
  6471.      massive window refresh problems, sorry Russ :(
  6472.  
  6473.    * `term' should now be more robust when getting run from Workbench.
  6474.      It properly cleans up after itself when exiting and before the big
  6475.      initialization is done makes sure that enough stack space is
  6476.      around.
  6477.  
  6478.    * Some settings editors were using vars of the wrong size, this has
  6479.      been fixed.
  6480.  
  6481.    * After the startup changes I made `term' could rerun the initial
  6482.      setup procedure, causing the usual kind of nuisance. Also, very
  6483.      rarely it could call the wrong cleanup procedure when run from
  6484.      Shell.
  6485.  
  6486.    * `term' no longer forces the Workbench screen or the default public
  6487.      screen to stay open while it is running using a custom screen
  6488.      [Brad Harder].
  6489.  
  6490.    * Added a configurable delay for the "Wait..." command [Russell
  6491.      LeBar].
  6492.  
  6493.    * The popup gadget now places a checkmark in front of the currently
  6494.      active entry, i.e. the entry that was displayed before you hit the
  6495.      gadget and the popup menu was opened. Also, the popup layout code
  6496.      no longer forces the menu to come up with the last active entry
  6497.      below the mouse.
  6498.  
  6499.    * The phonebook access password entry no longer consists of two
  6500.      string requester popping up after one another, and hitting return
  6501.      in the first meaning "clear the current password". There is a
  6502.      proper interface for this purpose now with two string gadgets to
  6503.      enter and to repeat the new password (for safety reasons), plus a
  6504.      button to clear the current password.
  6505.  
  6506.    * In the phonebook, `term' no longer complains if the default
  6507.      translation/cursor/etc. file cannot be found when you first edit
  6508.      the settings of an entry.
  6509.  
  6510.    * When copying entries in the phonebook, each new entry gets a tag
  6511.      "copy of ..." prepended so you can tell the original and the
  6512.      copies easier apart.
  6513.  
  6514.    * Made the dial window smart refresh again. Popping it to the front
  6515.      did not refresh it.
  6516.  
  6517.    * The single character entry window now uses the current terminal
  6518.      font. Should I make this a configurable feature?
  6519.  
  6520.    * Finally got the status line layout right, the space left and right
  6521.      of the display boxes should be the same now.
  6522.  
  6523.    * `term' could miss window size changes, the IDCMP_SIZEVERIFY flag
  6524.      got enabled only for the fixed-size window, not for the one with
  6525.      the size gadget. Silly me...
  6526.  
  6527.    * `term' no longer crashes violently if gtlayout.library does not
  6528.      open.
  6529.  
  6530.    * When opening its window on a public screen, `term' now opens it as
  6531.      a visitor window.
  6532.  
  6533.    * In the capture settings, the review buffer settings are now on the
  6534.      last tab page [Russell LeBar].
  6535.  
  6536.    * Made the wait command text entry field a bit wider [Russell LeBar].
  6537.  
  6538.    * The wait command implementation is a bit smarter now. The command
  6539.      is now sent (a) before the event loop is entered, (b) reliably
  6540.      every n seconds as specified in the misc prefs and (c) when you
  6541.      close the requester [Russell LeBar].
  6542.  
  6543.    * Changed the order in which the tabs are drawn by the user
  6544.      interface support library. This has the benefit that the
  6545.      beginnings of the labels on overlapping tabs are shown rather than
  6546.      the endings [David Göhler].
  6547.  
  6548.    * The "Wait" feature now listens to the serial port and processes
  6549.      incoming data while the wait loop is running [Russell LeBar].
  6550.  
  6551.    * Shortened the transfer panel labels even further, I also merged
  6552.      the two top groups into a single group. I separated the gauge
  6553.      displays from the two vertical text displays and put them back
  6554.      into the bottom region of the window, just like in the old v2.4
  6555.      version :)  [Chris Hanson].
  6556.  
  6557.    * As an experiment, I put all the xpr, transfer and serial code of
  6558.      `term' v4.4 into this beta release and also turned off the
  6559.      compiler register parameter passing option. Please tell me if this
  6560.      makes things better or worse. Some users still reported problems
  6561.      with downloads, in particular small ISDN transfers would cause big
  6562.      trouble.
  6563.  
  6564.    * Added new dial modes (tone, pulse, modem, ISDN) in support of the
  6565.      ZyXEL 2864ID model [Christoph Lückel].
  6566.  
  6567.    * In popup menus, a bullet is used in place of the checkmark.  This
  6568.      is more consistent, as the menu choices are mutual-exclusive
  6569.      anyway [Russell LeBar].
  6570.  
  6571.    * The user interface layout library now does a binary search when
  6572.      looking up gadgets in its internal database. It used to do a
  6573.      straight linear search which could really cost time. This approach
  6574.      should be much better. Should be. Comments welcome.
  6575.  
  6576.    * The script recording code needed to treat leading, trailing and
  6577.      single spaces and double quotes differently. The old implementation
  6578.      just dumped the entire string, which could cause the spaces to get
  6579.      lost and the double quotes to confuse the parser. It now expands
  6580.      those spaces into \*32 and the double quotes into \*34 [Salvatore
  6581.      V. Barrera].
  6582.  
  6583.    * The new and improved "Wait" code was busy-waiting, a loop flag was
  6584.      not getting reset [Russell LeBar].
  6585.  
  6586.    * In the "Wait" loop, `term' no longer processes ARexx commands, it
  6587.      ignores and rejects them. Getting the ARexx processing to work
  6588.      correctly would be too hairy.
  6589.  
  6590.    * Tabs as supported by the user interface support library are now
  6591.      drawn right to left again.
  6592.  
  6593.    * Removed the entire transfer performance meter code.
  6594.  
  6595.    * Recompiled `term' with register parameters.
  6596.  
  6597.    * Made the XEM interface more robust and also managed to save some
  6598.      code on the way.
  6599.  
  6600.    * Recent changes made the close gadget of the single char entry
  6601.      window unusable. Fixed.
  6602.  
  6603.    * The menu layout code now accounts for very wide submenu items,
  6604.      such as may appear in the dial menu [Russell LeBar].
  6605.  
  6606.    * The key macro settings editor did not restore the original
  6607.      settings when hitting the Cancel button.
  6608.  
  6609.    * The area code settings editor did not properly dispose of the code
  6610.      list when hitting the Clear button.
  6611.  
  6612.    * All the `special' settings editors (character translation, key
  6613.      macros, cursor keys, hotkeys, speech, sound, area codes, traps)
  6614.      now follow a common interface model. They all sport a Discard
  6615.      button now which, if hit, will cause the configuration they belong
  6616.      to to drop the settings. This solves the problem of picking a
  6617.      settings file and not being able to ever get rid of it again.
  6618.  
  6619.    * The XPR transfer window creation code is now much smarter when
  6620.      deciding whether to activate the window or not.
  6621.  
  6622.    * Went through another great renaming. The configuration files
  6623.      `term' will read by default now must be using the following names:
  6624.  
  6625.      Now                  Old
  6626.      -------------------  --------------------
  6627.      phonebook.prefs      term_phonebook.iff
  6628.      hotkeys.prefs        term_hotkeys.iff
  6629.      speech.prefs         term_speech.iff
  6630.      fastmacros.prefs     term_fastmacros.iff
  6631.      functionkeys.prefs   term_macros.iff
  6632.      macros.prefs
  6633.  
  6634.      The old naming conventions were obsolete anyway, but `term' used
  6635.      to support these names in previous releases. I just removed all
  6636.      the code which was concerned with providing name backwards
  6637.      compatibility. You will need to rename these files yourself or
  6638.      make copies of the files under the new names.
  6639.  
  6640.    * Just like with every other `term' release I noticed that the tool
  6641.      and script launching code was broken and started to rewrite the
  6642.      whole damn thing again. This time I really have reason to believe
  6643.      that I got it right. I also removed the 1.2 style kludge code to
  6644.      fix console task and output streams.
  6645.  
  6646.    * As usual, the ARexx commands GETATTR and SETATTR were broken to a
  6647.      certain degree. Chances are good I fixed them this time. The
  6648.      translationprefs.x.send and translationprefs.x.receive items now
  6649.      also return much more sensible data.
  6650.  
  6651.    * At the very last minute and at really great expense, this very
  6652.      `term' release now supports fractional costs when doing phone rate
  6653.      accounting. Um, take care, this feature made it necessary to
  6654.      change the rates file format, it's not backwards compatible.
  6655.      Happy New Year :)
  6656.  
  6657.    * Rearranged rates settings edit controls. This arrangement should
  6658.      be more logical than the old one. I also fixed a few all-time
  6659.      nuisances, such as most of the control deactivating themselves
  6660.      when you least expect them to.
  6661.  
  6662.    * The area code panel now finally sports a "Copy" button. I also
  6663.      fixed the case in which either pattern or title could get lost
  6664.      when jumping between list items.
  6665.  
  6666.    * The "lost string gadget contents" problem could also show up with
  6667.      the trap editor, the fast macro editor and the phonebook, so I
  6668.      added extra code to take care of that.
  6669.  
  6670.    * The setup code lost the locations of phonebook, fast macros,
  6671.      function keys, etc. and always assumed it was safe to look into
  6672.      term:config. This was a bug which affected the entire setup code.
  6673.      Fixed. [Martin Berndt].
  6674.  
  6675.    * You can now assign a specific title to the terminal window if it
  6676.      opens on a public screen.
  6677.  
  6678.    * Changed the phone rate format again. Now even the time per unit
  6679.      can be a fractional value. This is how it was originally supposed
  6680.      to be.
  6681.  
  6682.    * Small fixes to the user interface support library. The most
  6683.      prominent feature affected is the password entry gadget;
  6684.      previously, you had to hit return in order to make `term' accept
  6685.      whatever you had entered.
  6686.  
  6687.    * Big changes to support proper phone rate accouting. All the old
  6688.      code is gone and has been replaced by an all new accounting task.
  6689.      Hey, it even appears to work correctly.
  6690.  
  6691.    * Whilst hacking at the accounting code I also rewrote the online
  6692.      state tracking and update code. I'll be mighty suprised if it
  6693.      works...
  6694.  
  6695.    * Changed the way `term' creates its own command search path when
  6696.      getting launched from Workbench. The current implementation should
  6697.      be much more compatible than the old way used to be. This should
  6698.      fix the odd "Execute command" and ARexx script launch crashes.
  6699.  
  6700.    * Updated the terminal window resizing code; it now takes the status
  6701.      line into account and updates the window contents as soon as
  6702.      possible.
  6703.  
  6704.    * The new switch "Auto-adapt window size" in the terminal settings
  6705.      should simplify setting the number of columns and rows the
  6706.      terminal window uses. Previously, in order to make the window size
  6707.      affect the number of terminal columns and rows you had to set the
  6708.      columns/rows sliders to "Max.".  Now you just have to enable the
  6709.      switch.
  6710.  
  6711.    * Fixed an Enforcer hit in the menu creation code.
  6712.  
  6713.    * Tried to make the phonebook copy & add code more robust.  Still,
  6714.      something is not right here...
  6715.  
  6716. Changes introduced with v4.5:
  6717. *****************************
  6718.  
  6719.    * Added a bunch of new OwnDevUnit options:
  6720.  
  6721.     `Do not use if device is in shared mode'
  6722.           This used to be the default in v4.4. I've had a few good
  6723.           ideas in my life, this wasn't one of them. Now it's a
  6724.           configurable option [Andreas Kirchwitz].
  6725.  
  6726.     `Release device when online'
  6727.           The default behaviour used to be not to let go of the device
  6728.           if you are still online. But perhaps this is just what you
  6729.           want. Now you can.
  6730.  
  6731.     `Release device when dialing'
  6732.           If your uucp netcall catches you off guard while `term' is
  6733.           still dialing and not getting anywhere, this switch will tell
  6734.           `term' to let go of the device driver. Please note that
  6735.           `term' will not start to redial when the device becomes
  6736.           available again.
  6737.  
  6738.    * The OwnDevUnit choices are now radio buttons rather than one wide
  6739.      cycle gadget [Chris Hanson].
  6740.  
  6741.    * The character conversion tables now show the numeric codes of the
  6742.      characters in several flavours (binary, octal, hex, you name it)
  6743.      [Chris Hanson].
  6744.  
  6745.    * The text buffer screen now gets the colours right even if it opens
  6746.      in 32K/64K/16M colours [Frank Mariak].
  6747.  
  6748.    * The "RTS/CTS (DSR)" handshaking mode now causes the device to be
  6749.      opened with RTS/CTS handshaking enabled before the DSR signal is
  6750.      checked. As it turns out, it didn't work the other way round.
  6751.  
  6752.    * Major new addition: for easy debugging and the shocking good looks
  6753.      of it, there is a new window to enter single characters
  6754.      graphically. It's called "Single character entry" and sports a
  6755.      button for every ISO-8859-1 character on this world. Click on the
  6756.      character you want (yes, there's a neat BOOPSI gadget behind it)
  6757.      to get it sent [Chris Hanson].
  6758.  
  6759.    * The XPR interface now uses a different approach to read data from
  6760.      the serial line. The overhead involved is much lower than in all
  6761.      previous `term' releases.
  6762.  
  6763.    * The dialer sent the modem exit commands on very rare occasions
  6764.      only, it now does it consistently.
  6765.  
  6766.    * Lots of minor changes in the user interface code.
  6767.  
  6768.    * The single character entry window came out black on black in 16
  6769.      colour mode [Frank Dürring].
  6770.  
  6771.    * While I was updating the single character entry window I added a
  6772.      code display. While you pick the character its code appears in
  6773.      decimal, hexadecimal, octal and binary in the window title bar.
  6774.  
  6775.    * The "SEND LITERAL" ARexx command now works as it should [Maxwell
  6776.      Daymon].
  6777.  
  6778.    * The windows menu now gets properly updated after the main
  6779.      screen/window is closed and reopened.
  6780.  
  6781.    * Freezing the buffer via the capture settings and saving them as
  6782.      your default settings never caused `term' to start up with the
  6783.      buffer frozen, it now does [Geoff Seeley].
  6784.  
  6785.    * There are now two different ways of getting data into the capture
  6786.      buffer. The old way of doing things (data flow) and a special
  6787.      procedure that stores all the data that gets scrolled or erased
  6788.      from the screen (review). The latter is more faithful to the
  6789.      general concept of a review buffer, but the catch is that you
  6790.      won't see the current contents of the main window. Not all the
  6791.      hooks & lines are in there yet, for example erasing characters in
  6792.      a single line is something the buffer does not track. The code is
  6793.      already in there, but it's commented out. Please let me know if
  6794.      you need it.
  6795.  
  6796.    * Another addition to the modem settings: if your phonebook entries
  6797.      don't use special modem configurations (in other words, they use
  6798.      the main modem configuration) and you have some modem
  6799.      initialization and cleanup commands in the main modem
  6800.      configuration you do not want the modem to receive while it is
  6801.      dialing, you can now tell `term' not to send them.
  6802.  
  6803.    * Mucked around some more with the character raster code that backs
  6804.      cut & paste in the main window. Some optimizations in the code,
  6805.      responsible for clearing the screen when scrolling or erasing
  6806.      text, were not that reliable.
  6807.  
  6808.    * The dialer was releasing the device driver by request of the
  6809.      OwnDevUnit.library even if it had been configured not to yield it.
  6810.      Even worse, the dialer did not pay attention to whether it should
  6811.      release the device on request while dialing or not [Andreas
  6812.      Kirchwitz].
  6813.  
  6814.    * Another one bites the dust: the text cut & paste feature supported
  6815.      by the main window no longer gets the terminal emulation into
  6816.      trouble when double-clicking on a word while there is still text
  6817.      selected [Andreas Kirchwitz].
  6818.  
  6819.    * The transfer panel now finds resident commands given for the
  6820.      external transfer protocol programs to invoke [Andreas Wolff].
  6821.  
  6822.    * The transfer menu no longer gets ghosted if the default protocol
  6823.      is not an XPR library but an external transfer protocol [Andreas
  6824.      Wolff].
  6825.  
  6826.    * The `Upload' buttons found in the upload queue window now cause
  6827.      the current transfer queue to be sent even if it consists of only
  6828.      a single file [Andreas Wolff].
  6829.  
  6830.    * Changing the default transfer protocol from xpr library to
  6831.      external program can no longer bring the machine down.
  6832.  
  6833.    * `term' no longer bangs its head if you accidentally pick an
  6834.      external transfer program and leave the type of transfer protocol
  6835.      set to "XPR library". It now manages to display the error
  6836.      requester without crashing or trashing its own stack [Sven Reger].
  6837.  
  6838.    * The `improved' XPR serial I/O code was pulling far too much CPU
  6839.      time. Bob Maple reported about 45%, on my setup it was about 25%
  6840.      which I thought was pretty normal.  I went back to the old code
  6841.      and streamlined it a bit, it's now down to about 5%, so the 25%
  6842.      were not that normal after all [Bob Maple].
  6843.  
  6844.    * `term' no longer tells you that the function keys, translation
  6845.      tables, cursor keys or hotkeys have been changed on exit if this
  6846.      is not really the case [John Yeung].
  6847.  
  6848.    * The translation table editor lost the "Cancel" gadget, there
  6849.      really was no code backing it and thus Use and Cancel always got
  6850.      the same treatment.
  6851.  
  6852.    * Finally fixed the "No DSR signal detected" problem.  I promise.
  6853.  
  6854.    * The modem dialing prefs now sport two new options which will
  6855.      hopefully simplify dialing through a local PBX.  The "PBX dial
  6856.      command" will get inserted between dial prefix and phone number if
  6857.      the "Use PBX dial command" switch is enabled. By default the PBX
  6858.      dial command is set to "0,,," which will first send a 0 to dial
  6859.      out, then wait about six seconds (each comma tells the modem to
  6860.      wait a certain number of seconds; exactly how many seconds to wait
  6861.      can be configured through a modem register, on the ZyXEL U-1496
  6862.      this is register S8 which is by default set to 2) before starting
  6863.      to dial the `real' phone number.
  6864.  
  6865.    * Renamed "Verbose dialing" (silly name) to "Show modem responses".
  6866.  
  6867.    * Another rogue attempt at improving data throughput in the XPR
  6868.      sread routine. I'm wondering if this has any positive effects, or
  6869.      as usual does not work as reliably as it really should.
  6870.  
  6871.    * Caught some more cases in which the return code of ModifyIDCMP()
  6872.      was plainly ignored. Now all of them are covered.
  6873.  
  6874.    * The transfer performance window now gets properly backfilled,
  6875.      especially if the window opens on a 16 colour screen under
  6876.      Kickstart 3.x.
  6877.  
  6878.    * The Fast! macro window now always opens in a useable state.  This
  6879.      was not always the case in previous releases if the main window
  6880.      had the wait pointer set while the new window was about to get
  6881.      opened [Andreas Wolff].
  6882.  
  6883.    * Put the old code back into xpr_sread. Somehow none of my attempts
  6884.      to improve things in this area seem to bear any fruit [Martin
  6885.      Berndt].
  6886.  
  6887.    * Fixed the delete line ("Esc [ <n> L") and insert line ("Esc [ <n>
  6888.      M") commands which were really broken in one special case, which is
  6889.      if more lines were to be deleted/inserted than the current
  6890.      scrolling region would hold. This code never worked in all previous
  6891.      `term' releases (it would clear the entire screen, not just the
  6892.      part covered by the scrolling region), but this time it really
  6893.      crashed [Andreas Kirchwitz].
  6894.  
  6895.    * Unified review buffer and text buffer. Both services now share the
  6896.      same code and more or less the same features. This has its
  6897.      drawbacks and advantages. I really don't want to return to the old
  6898.      console.device style review buffer implementation, so you better
  6899.      get used to the new way of doing things ;)
  6900.  
  6901.    * Changed the layout of the translation panel buttons [Stellan
  6902.      Klebom].
  6903.  
  6904.    * When using an external transfer protocol program, prefixing the
  6905.      program name with "run" no longer causes the name of the transfer
  6906.      protocol to be reported as "Run". The "run" command is now skipped,
  6907.      hopefully causing the name of the program to be executed to show
  6908.      up.
  6909.  
  6910.    * The transfer configuration now by default gets the standard Hydra
  6911.      invocation commands copied into the binary protocol entries.
  6912.  
  6913.    * Changing the default transfer protocol to an external program did
  6914.      not always cause an immediate update of the status line, it does
  6915.      now.
  6916.  
  6917.    * Better ARexx script recognition within the transfer settings
  6918.      control panel. Previously, in order to have ARexx scripts
  6919.      recognized they had to have their executable file protection bits
  6920.      cleared.
  6921.  
  6922.    * Changed the way the default buttons look like. Now, what do you
  6923.      think?
  6924.  
  6925.    * Removed some historic rubble from the screen settings editor which
  6926.      caused screen display modes to be sorted out that would offer less
  6927.      than 640 columns in their default resolution [Russ LeBar].
  6928.  
  6929.    * Shuffled the controls in the serial and modem settings editor a
  6930.      bit [Russ LeBar].
  6931.  
  6932.    * New sort algorithm for phonebook and friends.
  6933.  
  6934.    * All new phonebook. This change is massive and most likely to
  6935.      attract the usual kind of trouble. No documentation exists for
  6936.      this new part of the program yet, sorry. I haven't decided yet how
  6937.      to implement certain features, such as what the checkbox next to
  6938.      the "Rates" settings will do.
  6939.  
  6940.    * Fixed another load of bugs in the user interface support library.
  6941.  
  6942.    * If the single character entry window fails to open, the checkmark
  6943.      near the menu item gets cleared.
  6944.  
  6945.    * The phonebook now uses the brand new popup gadgets.
  6946.  
  6947.    * Reassigned some keys in the phonebook [Russ LeBar].
  6948.  
  6949.    * Brought back the v4.3 style xpr_sread routine. Please give this a
  6950.      test and tell me if file transfer reliability improves.
  6951.  
  6952.    * The phonebook window will no longer expand to display 20 lines of
  6953.      text if there are less than these few entries in the phonebook
  6954.      list [Chris Hanson].
  6955.  
  6956.    * The phonebook window will grow in the horizontal direction to make
  6957.      more room for the single phonebook entries [Andreas Kirchwitz].
  6958.  
  6959.    * Just for fun, added support for VT52 escape sequences.  Except for
  6960.      "<ESC>^" and "<ESC>_" all should be properly implemented.
  6961.  
  6962.    * Duplicating an entry in the phonebook would discard special item
  6963.      tracking information in the new entry created, this has been fixed.
  6964.  
  6965.    * When saving a phonebook file, the currently highlighted group will
  6966.      be saved along with it. The next time the file is loaded, this
  6967.      very group will appear in the listview as the active group again.
  6968.  
  6969.    * `term' now reads the system screenmode, serial and font
  6970.      preferences to establish its power-up defaults.
  6971.  
  6972.    * The "RECEIVEFILE" ARexx command never paid any attention to the
  6973.      file name you could optionally provide, now it does [Stefan Falke].
  6974.  
  6975.    * If the serial device driver is released on request by
  6976.      OwnDevUnit.library you now get the choice to return to `term', to
  6977.      iconify `term' and to quit the program [Christian Hechelmann].
  6978.  
  6979.    * New options for the phonebook: you can now define which phonebook
  6980.      entries should go into an auto-dial list which `term' will start
  6981.      dialing right after startup. In addition to that, you can also
  6982.      tell `term' to keep redialing each entry in the list until it hits
  6983.      the last entry, which will cause it to exit. In order to stop
  6984.      this, either hit cancel in the dialing window, or turn off the
  6985.      "auto exit" feature in the phonebook/clear the dialing list. Last
  6986.      but not least there are new command line options/tooltypes to
  6987.      select a particular phonebook file to use and to turn on the auto
  6988.      dial and auto exit features even if the phonebook was saved
  6989.      without having these enabled [Don Schmelling].
  6990.  
  6991.    * The emulation settings now allow you to select how `term' responds
  6992.      to device attributes and identify commands. The options include
  6993.      VT200 (the default), VT102, VT101 and VT100. This option does in
  6994.      no way affect how the terminal emulation operates, i.e. if you
  6995.      switch to VT100 `term' won't ignore VT220 commands. Only the
  6996.      responses are affected [Rich Jesse].
  6997.  
  6998.    * Phonebook loading severly broken when using file prefs, fixed now
  6999.      [Martin Berndt].
  7000.  
  7001.    * With the phonebook file format changes the XPR library name was
  7002.      left blank. This in turn caused an unsigned counter variable to
  7003.      flip, and `term' enventually started to spin into the void...
  7004.      Fixed.
  7005.  
  7006.    * Changed the look of default buttons again. They are no longer
  7007.      quite that bold, but now the label text is.
  7008.  
  7009.    * Creating a new group now also updates the group label.
  7010.  
  7011.    * Page #3 of the emulation settings was missing, it's back again now.
  7012.  
  7013.    * Changed the layout of the phonebook buttons again [Chris Hanson].
  7014.  
  7015.    * Moved the phonebook sort options into a separate control panel
  7016.      [Russell LeBar].
  7017.  
  7018.    * Added memory allocation debugging code. To enable it, do the
  7019.      following:
  7020.  
  7021.      setenv termprealloc <byte count> setenv termpostalloc <byte count>
  7022.  
  7023.      For <byte count> insert the number of bytes to put before and
  7024.      behind all memory allocations `term' makes. The numbers will be
  7025.      rounded to multiples of 16. Please note that if you don't choose a
  7026.      prealloc value, the debugging code won't kick in. If you omit the
  7027.      termpostalloc but specify a prealloc value, `term' will use a
  7028.      default of 16 bytes as the postalloc value. To make things more
  7029.      interesting, once you've enabled the debugging code `term' will
  7030.      fill all its memory chunks not allocated with MEMF_CLEAR with
  7031.      $DEADBEEF. When using the debugging code, please run SegTracker
  7032.      and Sushi (preferably with a 128K buffer) in the background and
  7033.      capture its output to a file. Oh, by the way, `term' will also
  7034.      remember the largest and smallest allocation made. I plan to add
  7035.      texture mapping to the spheres in the future.
  7036.  
  7037.    * Implemented DECANM and VT52 "Enter ANSI mode" commands. Both the
  7038.      VT52 and the VT220 emulation use the "<ESC>H" command for
  7039.      different purposes. The implementation now honors the mode in
  7040.      which the emulation operates [Andreas Kirchwitz].
  7041.  
  7042.    * `term' no longer forgets about the location of the cursor key,
  7043.      translation, etc. files and assumes that they are to be found in
  7044.      the default locations [Andreas Kirchwitz].
  7045.  
  7046.    * Added a new raw file capture mode, so one can make verbatim file
  7047.      captures without having to go through the capture settings and
  7048.      locate the right switch.
  7049.  
  7050.    * Phonebook entries tagged to go into the quickdial menu which are
  7051.      placed in groups now appear in submenus of the quickdial menu. If
  7052.      all the entries come from just one single group, however, no
  7053.      submenus will be created.
  7054.  
  7055.    * Fixed some more bugs in the popup and menu layout code.
  7056.  
  7057.    * You can now rename groups by tagging all members of the group and
  7058.      clicking the "Make group" button. In the requester to pop up,
  7059.      enter the new name of the group [Russell LeBar].
  7060.  
  7061.    * The text buffer display code crashed under v2.04. After chasing it
  7062.      for three hours it finally surfaced in the scrollbar creation
  7063.      code. Thanks go to Peter Banville for being so persistant :)
  7064.  
  7065.    * The XPR init code was throwing the wrong library names in case the
  7066.      setup went wrong. Fixed.
  7067.  
  7068.    * In the phonebook, clicking on the "rates" settings checkbox now
  7069.      does something sensible. If the button gets ticked, it will receive
  7070.      default rates settings. If the checkmark is cleared, all the rates
  7071.      settings associated with it will get zapped.
  7072.  
  7073.    * "Dial" is now the default button for the phonebook user interface,
  7074.      I also edited some phonebook gadget labels a bit [Chris Hanson].
  7075.  
  7076.    * The phonebook window title now keeps track of the number of
  7077.      phonebook entries and those which are tagged [Andreas Kirchwitz].
  7078.  
  7079.    * The "Select by pattern" code had the selection mode reversed, i.e.
  7080.      "tag matching entries" would untag entries, even if they weren't
  7081.      tagged - with all the usual consequences (can you say "BANG"?).
  7082.  
  7083.    * Sorting single groups would trash large amounts of memory (Russ
  7084.      was right), as the array to be sorted would hold only a single
  7085.      entry, a memory allocation of the wrong size took place.
  7086.  
  7087.    * The editing window now responds to the cursor left/right keys,
  7088.      hold down any shift key to move to the beginning or the end of the
  7089.      list.
  7090.  
  7091.    * "Sort" is now the default button for the phonebook sort panel,
  7092.      this used to be "Sort+Close".
  7093.  
  7094.    * Rebuilding the main menu did not protect itself well enough
  7095.      against changes in the quick dial menu area, which could cause
  7096.      lots of Enforcer hits and worse.
  7097.  
  7098.    * The menu builder would depend on the order of phonebook entries to
  7099.      go into groups. It no longer does, I also removed the limitation
  7100.      of the maximum number entries to go into the quick dial menu.
  7101.      Watch out, if `term' runs out of space it will fall back to the
  7102.      default menu layout without telling you what went wrong.
  7103.  
  7104.    * The phonebook entry edit window now sports a "Hide" checkbox which
  7105.      is by default checked. If checked, the window won't display or let
  7106.      you edit the user name and password [Russell LeBar].
  7107.  
  7108.    * Cleared out a lot of dead code, this cut the program size a bit.
  7109.  
  7110.    * In sixteen colour mode the default text rendering colour is now
  7111.      colour #7, this used to be #15 (i.e. #7 with highlighting). This
  7112.      makes colouring more consistent with the ANSI specs and avoids
  7113.      silly "white on white" rendering.
  7114.  
  7115.    * `term' now requires gtlayout.library v24 to run, so make sure you
  7116.      have it installed.
  7117.  
  7118.    * Replaced all cycle gadgets that were acting as page selectors by
  7119.      the new tab gadgets. I'm still not entirely happy with the visual
  7120.      design of these, point & click is also a bit difficult if the tabs
  7121.      are overlapping one another. The [Tab] key still moves you through
  7122.      the single pages, plus there is a new feature known as "strumming",
  7123.      i.e. you can hold down the mouse button and drag the pointer across
  7124.      all tab tags to see which choices are available. The tags will
  7125.      appear to be plucked out a bit while you review them. When you let
  7126.      go of the mouse button the tag you are currently viewing will
  7127.      become the active tag and the page will be rebuilt. FYI, the tab
  7128.      gadgets will eat a lot of chip memory, please keep an eye on this
  7129.      and let me know if this is a problem for you.
  7130.  
  7131.    * At the end of an upload through the built-in ASCII transfer
  7132.      routines `term' would invoke the download macro [Mirko Lukas].
  7133.  
  7134.    * Flipping through groups in the phonebook did not update the
  7135.      "current" entry counter, in fact the code was forgetting about it
  7136.      but did not show this in the user interface.
  7137.  
  7138.    * No longer uses buffered I/O when talking to the printer device.
  7139.  
  7140.    * Shuffled the buttons in the phonebook window again [Russell LeBar].
  7141.  
  7142.    * The tab key wasn't flipping pages properly in the transfer protocol
  7143.      editor panel [Russell LeBar]. The same was true for the internal
  7144.      ASCII send/receive setup panel.
  7145.  
  7146.    * More label and menu changes to support the tab gadgets [Russell
  7147.      LeBar].
  7148.  
  7149.    * Small visual changes to the tab gadget tags; there are now fine
  7150.      separators lines around the edges.
  7151.  
  7152.    * Added a shortcut to the emulation settings to make the emulation
  7153.      BBS-ANSI compliant. Just hit the checkbox to have the relevant
  7154.      options updated. It ought to update the terminal options as well,
  7155.      as a typical BBS-ANSI display measures 80x25 characters and most
  7156.      likely uses the IBM PC style font. However, it doesn't since this
  7157.      goes beyond the scope of this settings editor.
  7158.  
  7159.    * The menu layout code did not handle submenu items properly that
  7160.      would end up at the end of the menu list and would need to be
  7161.      shifted around in order to avoid having their hit boxes hang over
  7162.      the right screen border. This was tough to fix and even tougher to
  7163.      find in the first place...
  7164.  
  7165.    * Finally (!) caught the
  7166.      not-quite-that-rare-but-still-very-surprising case in which the
  7167.      font sensitive layout gadget procedure within gtlayout.library
  7168.      would loop forever without getting anywhere. This was happening
  7169.      frequently when using topaz/8 as the user interface font and with
  7170.      screen resolutions that did not support overscan.  Note that
  7171.      `term' will try to open a screen in the right size, but if the
  7172.      requested screen size is unavailable, it may decide to open the
  7173.      window anyway, even if this causes gadgets to hang over the window
  7174.      borders. Much better than not opening the window at all, or what
  7175.      do you think?
  7176.  
  7177.    * The tapedeck control button images now have a minimum size limit,
  7178.      so they look proper on low resolution displays.
  7179.  
  7180.    * The single menu strips are once again placed closer together. A
  7181.      total of two pixels in between neighbouring strips is used.
  7182.  
  7183.    * Fixed the other control sequence that was used both by the VT220
  7184.      emulation and the VT52 code ("<ESC> D") [Matthias Scheler].
  7185.  
  7186.    * Caught a very rare bug in the phonebook. If no phonebook file was
  7187.      loaded, and if you were loading a new phonebook file to include
  7188.      groups, using a special default group, `term' did not get the
  7189.      group display and the phonebook list right. Hitting any entry would
  7190.      invariably cause two more or less harmless Enforcer hits.
  7191.  
  7192.    * The screen displaymode picker revisited. I killed the filter, but
  7193.      the minimum size tags remained.
  7194.  
  7195.    * The commands to change the text size (DECHDL through DECDWL) could
  7196.      enable the text cursor too early, which would leave ugly artifacts
  7197.      on the screen. This would rarely happen in real life as the speed
  7198.      at which data had to be fed into the emulation was far beyond
  7199.      100,000 chars/second to make the bug manifest itself.
  7200.  
  7201.    * Alas, more changes. This time I combed the screen settings editor
  7202.      for dead code and indeed found a lot, plus certain routines I must
  7203.      have written while I apparently was not fully conscious. The editor
  7204.      frequently cancelled the wrong pages, did not update the colour
  7205.      palette when switching colour modes and moved in utterly strange
  7206.      and mysterious ways when trying to determine whether the user
  7207.      should be allowed to change the colour palette. In a nutshell,
  7208.      your basic waste of code, time & reliability.
  7209.  
  7210.    * Minor changes to the serial and terminal settings editors.
  7211.  
  7212.    * Part of the list management was badly broken, this affected in
  7213.      particular the upload list handling (the ARexx upload list, not
  7214.      the upload queue that has its own window). I'm not absolutely
  7215.      certain, but after going through the code for more than three
  7216.      hours I am no longer able to get the machine to crash through the
  7217.      ARexx "SENDFILE" command. It appears that the bug is fixed. Could
  7218.      you give this a try, Chris?
  7219.  
  7220.    * Caught some more cases in which list and node management routines
  7221.      could corrupt memory.
  7222.  
  7223.    * The ARexx "SENDFILE" command was sending the upload macro twice on
  7224.      exit.
  7225.  
  7226.    * Some text buffers handed over to dos.library in order to retrieve
  7227.      file names were not quite as long as `term' told dos they were.
  7228.      This could cause the usual kind of trouble, but only with very
  7229.      long file names.
  7230.  
  7231.    * The dialer did not update its OwnDevUnit watcher status when the
  7232.      serial device driver or the ODU options were changed.
  7233.  
  7234.    * Untag/tag by pattern was still broken, leading to weird select
  7235.      states in the phonebook.
  7236.  
  7237.    * Swapped the "Use" and "Copy" buttons in the phonebook [Chris
  7238.      Hanson].
  7239.  
  7240.    * Made the left button row of the phonebook a little smaller by
  7241.      changing the "Exit when finished" checkbox label to "Auto exit".
  7242.      Not that elegant and doesn't even avoid that the phonebook comes
  7243.      up on its own screen with a 640x200 sized display, but at least
  7244.      there is no longer so much of the window hidden from view. The
  7245.      only way to make the window a bit smaller would be to rename
  7246.      "Pattern..." to "Select..." or something, but I cannot do this
  7247.      anymore as the catalogs have been sent to the translators already
  7248.      :(
  7249.  
  7250.    * The checksumming code did not hit a nul-character, causing the
  7251.      startup to take much longer than necessary. It could also cause
  7252.      `term' to crash upon startup for no apparent reason.
  7253.  
  7254.    * Finally (!) managed to fit the phonebook on a 640x200 sized screen.
  7255.      The button size precalculation was using the wrong button data. It
  7256.      did not take the modifications of the phonebook button arrangement
  7257.      into account that took place in the previous betas.
  7258.  
  7259.    * Squeezed a few more bytes out of the user interface support library
  7260.      code.
  7261.  
  7262.    * Fixed non-reentrancy problem with the user interface support
  7263.      library.
  7264.  
  7265.    * Gave `term' a test on an old A500plus. It runs on an 68k Amiga with
  7266.      2 MBytes of main memory, but not very comfortably.
  7267.  
  7268.    * The grouping window in the phonebook did not always close when it
  7269.      had better closed down. Now it does.
  7270.  
  7271.    * Removed the font scale button from the emulation setings which came
  7272.      back when I restored page #3.
  7273.  
  7274. Changes introduced with v4.4:
  7275. *****************************
  7276.  
  7277.    * Threw out the optimized scrolling code. It could slow things down
  7278.      on slow computers and wasn't working particularly well either.
  7279.  
  7280.    * Removed the code that did the jump scrolling by taking a look at
  7281.      how many line feeds were received in one go. This could slow
  7282.      things down and interfere with on-screen rendering, such as with
  7283.      on-line games like "Perihelion".
  7284.  
  7285.    * Now uses gtlayout.library v13 to layout the menus; now many more
  7286.      menu items and menus fit onto small screens.
  7287.  
  7288.    * Screens and windows now open large enough for the status line
  7289.      display to fit.
  7290.  
  7291.    * Put the optimized scrolling code back in. It should now be able to
  7292.      behave itself in an orderly fashion.
  7293.  
  7294.    * The screen saving/printing code is now smart enough not to include
  7295.      the status line in the bitmap that it is going to be output.
  7296.  
  7297.    * The phonebook now uses a fixed-width font when running under
  7298.      Kickstart 2.04.
  7299.  
  7300.    * The status line display boxes are a bit wider now, so hopefully no
  7301.      data will be cut off any more.
  7302.  
  7303.    * Simplified the jump scrolling code a bit, eliminating another
  7304.      level of data filtering. This should remove the odd slowdown that
  7305.      would occur when the modem delivered a large chunk of data.
  7306.  
  7307.    * Changed the way the download procedure queries how much space is
  7308.      still left on the destination filing system. This time it should
  7309.      get it right.
  7310.  
  7311.    * Fixed a weird memory alignment problem in the double-buffered file
  7312.      handling code.
  7313.  
  7314.    * Saving/loading the fast macro settings is now properly remembered,
  7315.      so `term' will no longer tell you that the settings have been
  7316.      changed upon exit unless they have really been changed and not
  7317.      saved to disk yet.
  7318.  
  7319.    * In the paged settings editors for screen, terminal and capture
  7320.      prefs the displays for screen mode and font no longer auto expand
  7321.      with their contents.
  7322.  
  7323.    * Insert mode now works properly again [Andreas Kirchwitz].
  7324.  
  7325.    * Fixed an Enforcer hit in the emulation settings when called from
  7326.      the phonebook [Matthias Scheler].
  7327.  
  7328.    * Fixed locale string lookup bug in file identification code, also
  7329.      added PNG file signature.
  7330.  
  7331.    * `term' no longer refuses to dial out if the modem is still online
  7332.      and the `protective mode' is enabled. In this case, a requester
  7333.      will pop up and ask you if you want to hang up the line before
  7334.      dialing out.
  7335.  
  7336.    * Small fixes for deep CyberGfx screens (15 bits and up).
  7337.  
  7338.    * The check to see if the serial device driver you picked from the
  7339.      list did really exist was looking at the wrong buffer.
  7340.  
  7341.    * The dialer checked for modem errors, but the scanner responsible
  7342.      for catching the modem message never actually passed this
  7343.      information to the dialer.
  7344.  
  7345.    * Changed the machine readable version number string; it now includes
  7346.      information to explain for which type of machine the program was
  7347.      compiled.
  7348.  
  7349.    * Added new "Direct connection" option to the serial settings. If
  7350.      enabled, this switch suppresses RTS/CTS warnings and disables the
  7351.      carrier check. This is useful for direct nullmodem connections and
  7352.      for using the Amiga as a dumb terminal.
  7353.  
  7354.    * Moved the "Alert" switch from the terminal settings to the
  7355.      miscellaneous settings. This made it necessary to bump the program
  7356.      revision number to v4.4.
  7357.  
  7358.    * You can now configure the opening size and position of the
  7359.      standard asl requesters (file, font, display mode) in the misc
  7360.      settings. Just select the positioning mode you want (centered or
  7361.      placed relative to the top left corner of the main window) and
  7362.      click on the "Edit..." button. A file requester window will open.
  7363.      Drag it to the position you want and change its size if necessary,
  7364.      then click on "Use". `term' will keep position and size as default
  7365.      values for the requesters to open.
  7366.  
  7367.    * Rearranged some settings editors, made some room between
  7368.      neighbouring radio buttons and checkboxes, added `Tab' key support
  7369.      to some editors which were missing this feature.
  7370.  
  7371.    * The notorious screen cloning feature did not work in previous
  7372.      releases, in fact gtlayout.library was broken in many ways and
  7373.      badly needed updating [Klaus Dürr].
  7374.  
  7375.    * Added LZX archive file type.
  7376.  
  7377.    * Sorry, no speedbar in this release, I just currently don't have
  7378.      the time to do it :(
  7379.  
  7380.    * Added another character send delay option, this time to the modem
  7381.      settings. Some weird east-asian built v.34 compliant modems will
  7382.      happily operate at 57600 baud, but get into real trouble when
  7383.      receiving plain modem dialing and initialization commands. The
  7384.      characters come in just too fast. A little delay between the
  7385.      characters being sent may help.
  7386.  
  7387.    * The `about' window now sports scrolling credits.
  7388.  
  7389.    * The phonebook will no longer load empty configuration items (key
  7390.      macros, fast macros, etc.) to edit if the names of the files are
  7391.      not given.
  7392.  
  7393.    * Due to a bunch of internal changes in order to support scaled
  7394.      characters in more consistent fashion, the option to select
  7395.      half-width characters was removed from the emulation settings. Cut
  7396.      & paste with non-normal sized characters still does not work
  7397.      properly on the screen.
  7398.  
  7399.    * Redid the logic for the RTS/CTS (DSR check) handshaking mode.
  7400.      `term' now opens the serial device driver with RTS/CTS handshaking
  7401.      disabled, checks the DSR signal and then if necessary closes the
  7402.      device driver and reopens it with RTS/CTS handshaking enabled.
  7403.  
  7404.    * `term' no longer locks the serial device driver for exclusive
  7405.      access through OwnDevUnit.library when told to open the driver in
  7406.      shared mode.
  7407.  
  7408.    * Loading the configuration and then choosing "Save configuration"
  7409.      from the main menu will save the current settings under the name
  7410.      of the configuration file loaded last.
  7411.  
  7412.    * The cursor key control panel now sports a "Default" button.
  7413.  
  7414. Changes introduced with v4.3:
  7415. *****************************
  7416.  
  7417.    * Fixed an Enforcer hit in the code that would open the file
  7418.      transfer window in case of error.
  7419.  
  7420.    * Colour palettes are now 24 bits wide (in reality even 96 bits, but
  7421.      the user interface does not support this precision).
  7422.  
  7423.    * Added support code for AmigaUW terminal window resizing.
  7424.  
  7425.    * Fixed another bug in gtlayout.library which would cause trouble
  7426.      with palette editor gadgets using only two colours.
  7427.  
  7428.    * Fixed another Enforcer hit in the XEM settings editor.
  7429.  
  7430.    * Updated the screen settings editor. It no longer displays options
  7431.      that cannot be changed.
  7432.  
  7433.    * The "Dial number" function would use the wrong temporary buffer
  7434.      when prompting to enter the number to dial.
  7435.  
  7436.    * Opening the status window no longer causes crashes. It was the
  7437.      call to DateStamp() and DateToStr() which caused the Task to
  7438.      handle the status window to crash. It's a process now.
  7439.  
  7440.    * Cut & paste while the chat line is active now works properly.
  7441.  
  7442.    * The chat line is now unavailable if an external terminal emulation
  7443.      is active.
  7444.  
  7445.    * The dialing menu items now get properly disabled if the program
  7446.      starts up in online state.
  7447.  
  7448.    * Made the only (!) call in gtlayout.library which could cause
  7449.      AmigaDOS to be called an option for Processes only. It will no
  7450.      longer crash when called by a Task.
  7451.  
  7452.    * When running under Kickstart 2.04, the screen overscan mode is by
  7453.      default set to the text overscan size.
  7454.  
  7455.    * The built-in ASCII transfer windows now also get size- adjusted in
  7456.      order to avoid overlapping the status line.
  7457.  
  7458.    * Added a startup notice to explain that *this* really is a beta
  7459.      test release.
  7460.  
  7461.    * The program now consists only of load hunks smaller than 100000
  7462.      bytes each. This should make it possible to load the program even
  7463.      if the system memory is greatly fragmented.
  7464.  
  7465.    * Finally discovered why the rate panel editor would swallow the
  7466.      first cost entry. Turning off the SAS/C global optimizer did the
  7467.      trick.
  7468.  
  7469.    * The chat line text could become unreadable with some text pen
  7470.      choices. According to the BOOPSI documentation my original code
  7471.      was correct, but I discovered that the ROM code actually expects a
  7472.      different data format.
  7473.  
  7474.    * The colour palette management code would not work properly under
  7475.      Kickstart 2.04.
  7476.  
  7477.    * Fixed three long standing bugs in the terminal emulation code. If
  7478.      a command would erase/clear more lines/characters than the screen
  7479.      would hold memory trashing was not to be avoided. This has been
  7480.      fixed.
  7481.  
  7482.    * An uninitialized variable in the colour palette setup code could
  7483.      cause real trouble, crashing the machine almost instantly.
  7484.  
  7485.    * The review buffer process did not protect itself against sudden
  7486.      removal, leading to crashes after the review window was closed.
  7487.  
  7488.    * The "READ CR" ARexx command now does again what it should do.
  7489.  
  7490.    * The code that would cause Enforcer hits within rexxsyslib.library
  7491.      was rewritten to use a different technique to tell free messages
  7492.      and Rexx messages apart.
  7493.  
  7494.    * The AmigaUW TTY resizing code would crash the machine if the
  7495.      serial device was unavailable. This would happen for example if
  7496.      the serial device driver did not open upon startup.
  7497.  
  7498.    * The dialing window now displays which dial list entry will be
  7499.      dialed next when in redial delay mode.
  7500.  
  7501.    * `term' now properly allocates its work bitmaps when running under
  7502.      Kickstart 3.x, previously it would occasionally fall back to
  7503.      constructing bitmaps on its own which could cause speed penalties.
  7504.  
  7505.    * Another one bites the dust. Found a really long standing bug in
  7506.      the double-buffered file routines. Can you say buffer trashing,
  7507.      memory losses, crashes? The code used to be very vulnerable to
  7508.      memory shortages. I fixed this and also threw in some extra code
  7509.      to make the buffers quad-longword aligned to help '040 systems
  7510.      with DMA hard disk controllers.
  7511.  
  7512.    * There is now a bit of new code in the program which opens
  7513.      gtlayout.library. If there still is an old library release in
  7514.      memory it gets flushed first, then the library is reopened.  This
  7515.      has the effect of forcing the library to get reloaded from disk.
  7516.  
  7517.    * Even more changes to the terminal emulation code; previous
  7518.      releases always ignored the current background colour when
  7519.      clearing lines, the screens or moving text around. This has been
  7520.      fixed. Some code also did BitMap peeking which is strictly
  7521.      speaking not allowed. When using fonts with an odd height smooth
  7522.      scrolling could leave pixel trash behind.  Some routines, notably
  7523.      those responsible for scrolling and erasing display text, never
  7524.      made sure that the area to scroll/erase was within valid bounds.
  7525.      As the low-level routines always counted upon this data to be
  7526.      correct nasty crashes could result. Some of the new code is far
  7527.      from being highly efficient, but should be much more robust than
  7528.      the old routines. Anyway, those folks looking for a high-speed
  7529.      terminal emulation probably have already chosen a different
  7530.      program.
  7531.  
  7532.    * The screen settings editor would occasionally assign the wrong
  7533.      colour palette to phone book entry configurations.  This has been
  7534.      fixed.
  7535.  
  7536.    * The routine to reset the text colours to something readable did
  7537.      not take the new emulation pen settings into account. This has
  7538.      been fixed.
  7539.  
  7540.    * To aid debugging, there is a new switch in the modem settings
  7541.      which tells the dialer to echo commands sent to the modem and to
  7542.      show the modem responses.
  7543.  
  7544.    * Added another switch to the misc. settings editor. You can now
  7545.      disable those annoying "File ... already exists, do you want to
  7546.      replace it?" requesters.
  7547.  
  7548.    * Major revamp of the file transfer settings editor. First off, it's
  7549.      no longer that tall. The "Page" cycle gadget cycles through all
  7550.      the individual entries. As there are: the default protocol, the
  7551.      ASCII transfer settings, the text transfer settings and the binary
  7552.      transfer settings. For each protocol you will find another cycle
  7553.      gadget, a text entry field and a big, friendly button labeled
  7554.      "Edit settings...". The cycle gadgets will let you choose between
  7555.      2..4 possible settings for each protocol. "XPR library" uses the
  7556.      good old XPR interface, the text entry field holds the name of the
  7557.      library to use. "Internal" uses the built-in code. "Default" uses
  7558.      the default protocol. "External program" selects an external
  7559.      program to handle the file transfer, the text entry field holds
  7560.      the name of the program and possible program parameters. If using
  7561.      the "External program" mode clicking on the downward pointing
  7562.      `select' button will bring up another editor. Here you can choose
  7563.      the program to use and you can edit the command line options it
  7564.      should use. Pressing a button will append the corresponding escape
  7565.      sequence:
  7566.  
  7567.     `1 File (= %f)'
  7568.           Inserts a single file name when the program is executed.  A
  7569.           file requester will pop up if necessary.
  7570.  
  7571.           *NOTE: Case matters; %f inserts the file name along with its
  7572.           complete path %F inserts the plain file name only, omitting
  7573.           the path.*
  7574.  
  7575.     `Files (= %m)'
  7576.           Inserts a list of file names when the program is executed.  A
  7577.           file requester will pop up if necessary.
  7578.  
  7579.           *NOTE: Case matters; %m inserts the file names along with
  7580.           their complete paths, %M inserts the plain file names only,
  7581.           omitting their paths.*
  7582.  
  7583.     `Port (= %p)'
  7584.           Inserts the ARexx port name `term' is currently using.  Very
  7585.           useful in conjunction with HydraCom.
  7586.  
  7587.     `Device (= %d)'
  7588.           Inserts the name of the serial device driver `term' is
  7589.           currently using. This comes in handy with external programs
  7590.           which permit sharing a device driver with other programs.
  7591.  
  7592.     `Unit (= %u)'
  7593.           Inserts the serial device driver unit number `term' is
  7594.           currently using. This comes in handy with external programs
  7595.           which permit sharing a device driver with other programs.
  7596.  
  7597.     `Source (= %<)'
  7598.           Inserts the name of the upload path for the current transfer
  7599.           mode (ASCII, text, binary).
  7600.  
  7601.     `Dest. (= %>)'
  7602.           Inserts the name of the download path for the current
  7603.           transfer mode (ASCII, text, binary).
  7604.  
  7605.     `Screen (= %s)'
  7606.           Inserts the name of the public screen `term' is running on.
  7607.  
  7608.           *NOTE: May be an empty string.*
  7609.  
  7610.     `Baud rate (= %b)'
  7611.           The currently selected transfer speed in bits/second (Baud).
  7612.  
  7613.     `Connect. rate (= %c)'
  7614.           The transfer speed your modem made the connection with.
  7615.  
  7616.           *NOTE: this will be the same value as given by %b if the
  7617.           modem is not currently connected.*
  7618.  
  7619.      The escape sequence %% expands into %, in case you need it. The
  7620.      file transfer functions support the upload list window and the
  7621.      ARexx file transfer list: if %f/%F/%m/%M escape sequences are
  7622.      found in the command line text they will be replaced by the upload
  7623.      list if necessary. Please note that when using an external program
  7624.      no file names will be removed from the ARexx upload list. Here are
  7625.      two examples to get you started:
  7626.  
  7627.      `run hydracom device %p speed %b line %c nocarrier rec %> get'
  7628.  
  7629.      This will invoke hydracom and start downloading into your download
  7630.      drawer. Put this in to the "Receive" field of your binary transfer
  7631.      settings.
  7632.  
  7633.      `run hydracom device %p speed %b line %c nocarrier rec %> send %m'
  7634.  
  7635.      This will also invoke hydracom. First you will be asked to select
  7636.      the files to send, then hydracom will transmit them. Put this into
  7637.      the "Send" field of your binary transfer settings.
  7638.  
  7639.      `term' runs these commands in synchronous fashion, this is why the
  7640.      "run" command is necessary above. Hydracom needs to interface to
  7641.      `term' while it is running and not currently waiting for the
  7642.      command to complete its task. Aside from the fact that commands
  7643.      are executed in synchronous fashion, they are started just as if
  7644.      you would invoke them using the "Execute AmigaDOS command..."
  7645.      function.
  7646.  
  7647.    * Fixed a security hole in the review buffer processing code.
  7648.      Previously, the review buffer window could easily lock up when
  7649.      receiving new data.
  7650.  
  7651.    * Rewrote most of the carrier tracking code. If the carrier is lost
  7652.      during a file transfer `term' will now properly notice that it is
  7653.      no longer online and run through the usual cleanup procedures.
  7654.  
  7655.    * More changes to the file transfer settings; for each protocol you
  7656.      use you can now define a specific signature. If `term' sees this
  7657.      signature in the input data stream it will automatically invoke the
  7658.      protocol in question. The exception is the default protocol which
  7659.      is handled a bit differently. There is no distinction between an
  7660.      upload and a download protocol, since this is how the default
  7661.      protocol works. If the default protocol is an XPR library the
  7662.      library will be open all the time. Whenever the default protocol
  7663.      is invoked, you will be prompted to select the transfer type (text
  7664.      or binary as usual). For auto-activating XPR protocols the
  7665.      signatures will probably be ignored.
  7666.  
  7667.      *IMPORTANT: If you are using the Z-Modem auto-upload feature you
  7668.      *MUST* invoke the transfer settings and pick the send signature
  7669.      for the default protocol. Click on the select button at the right
  7670.      side of the "Signature" text entry field. From the list that pops
  7671.      up select "Z-Modem" and save your settings back to disk. If you
  7672.      fail to do so, Z-Modem auto-uploads will *NOT* work.*
  7673.  
  7674.      The signatures are scanned in the following order:
  7675.  
  7676.      Default protocol (upload)   Default protocol (download)   ASCII
  7677.      upload   ASCII download   Text upload   Text download   Binary
  7678.      upload   Binary download
  7679.  
  7680.      This means that if you use the same signature for the Default
  7681.      protocol and the Binary upload then the Default protocol will be
  7682.      invoked.
  7683.  
  7684.      For now, there are only three signatures built into the program
  7685.      that can be picked from a list: Z-Modem, Hydra and QuickB. QuickB
  7686.      really is not a true signature since it consists only of the ENQ
  7687.      character. Please note that different built-in signature lists
  7688.      will be presented for the upload and download settings.
  7689.  
  7690.      For xprzmodem.library it only makes sense to use the upload
  7691.      signature.  Starting with v2.0 the library will always filter out
  7692.      the download signature and start the download process all on its
  7693.      own.
  7694.  
  7695.      Hydra is a bit of a problem as it uses the same signature both for
  7696.      uploads and downloads. Take care; if things don't work as they
  7697.      should it may be better to delete the Hydra signature.
  7698.  
  7699.      And before I forget to mention it: the signatures are entered in
  7700.      the (hopefully) familiar command sequence syntax, e.g. ^X stands
  7701.      for Control+X and \ stands for the backslash.
  7702.  
  7703.    * The "\c <Menu name>" control sequence now checks if the menu
  7704.      function it is about to call is enabled.
  7705.  
  7706.    * Even more changes to the file transfer settings; I moved some data
  7707.      from the misc settings over here. However, this beta version does
  7708.      not move your misc settings values over into the transfer settings.
  7709.      You need to to this manually.
  7710.  
  7711.    * Renamed "Overwrite warning" to "Protective mode". Now this is what
  7712.      it does: in every situation (overwriting files, clearing the
  7713.      buffer, quitting the program, releasing the serial device driver,
  7714.      choosing a file/drawer/program) `term' now runs a test to see if
  7715.      either the settings are valid or asks if the user really wants to
  7716.      do what he is about to do (it's not that we don't trust you).
  7717.      Using the "Protective mode" switch you can turn off all those
  7718.      sanity checks.
  7719.  
  7720.    * Added another two terminal emulation control sequences for "ANSI"
  7721.      compliance.
  7722.  
  7723.    * The menu "Wait" command requester can now be closed with a single
  7724.      keystroke.
  7725.  
  7726.    * The program now uses special magic to make sure that all AmigaDOS
  7727.      and ARexx programs started receive proper search paths.
  7728.  
  7729.    * The button labels "|<", "<", ">" and ">|" have been replaced by
  7730.      proper glyphs.
  7731.  
  7732.    * The code to build the command line for external transfer protocols
  7733.      did not handle empty strings correctly. It does now.
  7734.  
  7735.    * The Hydracom example invocation commands listed in the previous
  7736.      section of this document were not correct. If you are using this
  7737.      protocol, please update the command lines as described in the
  7738.      previous section.
  7739.  
  7740.    * Any requester that shows just a single "Continue" button can now
  7741.      be closed with a single keystroke.
  7742.  
  7743.    * The status window now properly displays the name of the currently
  7744.      connected BBS.
  7745.  
  7746.    * Slight changes and enhancements to the user interface code.
  7747.  
  7748.    * String gadgets are now properly aligned in columns in the path and
  7749.      command settings editors.
  7750.  
  7751.    * The prescrolling/jump scrolling code now gets `out of the way' if
  7752.      the background colour is currently nonzero.
  7753.  
  7754.    * Slightly improved low-memory stability, especially during the
  7755.      initial setup procedure.
  7756.  
  7757.    * The "You don't have RTS/CTS handshaking enabled..." request now
  7758.      enables RTS/CTS handshaking with DSR checking if the user decides
  7759.      so.
  7760.  
  7761.    * The emulation pen selection now supports public screens again.
  7762.      Please note that the implementation is not perfect (which was the
  7763.      primary reason for disabling it in v4.2) and may not work properly
  7764.      when using the keyboard to pick the colours, i.e.  keystroke
  7765.      activation may produce unexpected results.
  7766.  
  7767.    * Added new tooltype/shell argument to specify the language the
  7768.      program is to use.
  7769.  
  7770.    * Some of the settings windows are now resizable. Please tell me if
  7771.      this causes any problems. The code is still a bit weird, for
  7772.      example some window sizes can cause the gadgets to overlap the
  7773.      window borders by one or two pixels.
  7774.  
  7775.    * Small changes to the user interface code. Fixed the notorious
  7776.      double-click bug.
  7777.  
  7778.    * The AmigaUW terminal resizing code would get invoked before the
  7779.      internal lines/columns variables were set up properly, causing the
  7780.      display to get messed up. This has been fixed.
  7781.  
  7782.    * When invoking an external file transfer protocol the program now
  7783.      checks if the file name given refers to an ARexx script (it reads
  7784.      the first 256 characters and looks for the comment that identifies
  7785.      an ARexx script), a plain AmigaDOS script (it takes a look at the
  7786.      script file attribute) and eventually accepts the program name as
  7787.      it is. If a file is identified as being a script file it receives
  7788.      special treatment.
  7789.  
  7790.    * Added another friendly reminder in case the user has enabled the
  7791.      "Connect auto-baud" switch. Apparently, a lot of users have this
  7792.      switch enabled without really knowing what it does and will get
  7793.      into real trouble when making a connection.
  7794.  
  7795.    * The chat line now gets activated when invoked via menu.
  7796.  
  7797.    * When failing to allocate enough colours for the terminal window
  7798.      `term' now falls back to four colour mode.
  7799.  
  7800.    * Rewrote the dialer (again). If you press skip/abort it will now do
  7801.      what it should do rather than ignoring your commands.  The
  7802.      original serial configuration also gets properly restored if the
  7803.      dialer fails to make a connection. Various nice side effects are
  7804.      included. For example, if in waiting state pressing the abort
  7805.      button immediately exits.
  7806.  
  7807.    * After finding out that the window resizing code did not work
  7808.      properly in programs derived from the review buffer window
  7809.      handling code I gave the original resizing routine another rewrite.
  7810.  
  7811.    * The ARexx "SEND" command now sports a new "LITERAL" option.  With
  7812.      this option the text to send will be transmitted literally, no
  7813.      embedded command sequences or special characters will be evaluated.
  7814.  
  7815.    * The chat line text entry field no longer filters control
  7816.      characters, even if you enabled this feature in the IControl
  7817.      system preferences editor.
  7818.  
  7819.    * The text buffer screen could hang when choosing to clear the
  7820.      buffer contents from the menu. This has been fixed.
  7821.  
  7822.    * The colour remapping that usually took place only in two colour
  7823.      mode (which tries to avoid mapping the same colour to text
  7824.      background and foreground) now also gets applied in four and eight
  7825.      colour modes. Previously, it would ignore the colour mode the user
  7826.      had chosen and just take a look at the depth of the screen the
  7827.      program was using. This could cause all kinds of trouble when
  7828.      running on a 256 colour public screen.
  7829.  
  7830.    * When running on its own public screen with a window border `term'
  7831.      could crash if there were still visitor windows open on the public
  7832.      screen.
  7833.  
  7834.    * `term' now opens screens as large as possible if the screen
  7835.      settings indicate a specific screen size, but the user has no
  7836.      means to change them. In previous program releases you would get
  7837.      whatever was found in the screen settings, even if you didn't have
  7838.      asl.library v38 or higher handy to change the dimensions.
  7839.  
  7840.    * The xON/xOFF handling code works a bit differently now. If you
  7841.      have the "Internal xON/xOFF handling" switch enabled in the serial
  7842.      settings `term' will now go into `holding' state when you press
  7843.      Control+S (= xON). To return to normal operation, press Control+Q
  7844.      (= xOFF). If the "Pass xON/xOFF through" switch is enabled, both
  7845.      xON/xOFF characters will be sent through to the remote, otherwise
  7846.      `term' will swallow them. The big difference between this handling
  7847.      and the old style of doing things is that `term' will no longer
  7848.      drop into `holding' state when receiving an xON character from the
  7849.      remote. The only way to bring `term' into `holding' state is by
  7850.      pressing Control+S.
  7851.  
  7852.    * The chat line now passes control characters and function key
  7853.      macros through to the main program as you type them, i.e. they
  7854.      will not show up in the text you type. The Tab key is special; if
  7855.      pressed, the tab character will be passed through to the main
  7856.      program. If you press Control+I the character will show up in the
  7857.      chat line.
  7858.  
  7859.    * Added a shortcut to select between pulse dialing and tone dialing.
  7860.      This requires that your dial prefix or suffix command includes the
  7861.      special command sequence \W. This sequence will translate into P
  7862.      for pulse dialing and into T for tone dialing. So in order to take
  7863.      advantage of this feature, you should change your dialing command
  7864.      to ATD\W and select the dialing mode you want. Please note that
  7865.      the dial mode option will be disabled if there is no \W in the
  7866.      dial prefix and dial suffix.
  7867.  
  7868.    * The default serial and modem setups are a bit different now.  As
  7869.      always, the program first tries to read the global system serial
  7870.      settings and converts them if necessary. If RTS/CTS handshaking is
  7871.      enabled, it now enables the RTS/CTS handshaking mode with DSR test
  7872.      in order to avoid lockups. If the serial settings could not be
  7873.      read the default setup now is 19,200 baud, 8-N-1 and RTS/CTS
  7874.      handshaking with DSR checking. The modem settings no longer
  7875.      include "ATZ\r" as the modem init command, the dial prefix now
  7876.      reads "ATD\W" and the default dial mode is tone dialing.
  7877.  
  7878.    * The default screen display mode settings are now taken from the
  7879.      default public screen.
  7880.  
  7881.    * Added another friendly reminder that is displayed whenever you
  7882.      upgrade from an older program release or start the program for the
  7883.      first time. The reminder will be displayed every time you start
  7884.      the program until you save the program settings.
  7885.  
  7886.    * Pasting the current clipboard contents now optionally converts
  7887.      line feed characters into carriage returns (there is a new option
  7888.      in the clipboard settings for this purpose).
  7889.  
  7890.    * `term' used to fake an immediate XPR abort by returning a read
  7891.      error in xpr_sread() in case the user had pressed the abort
  7892.      button. This really should not be necessary, I just rewrote the
  7893.      code to abort the read prematurely and to return whatever came in
  7894.      so far. This implies the hope that the protocol will eventually
  7895.      drop into xpr_chkabort() and find out what's cooking.
  7896.  
  7897.    * The chat line now gets properly redrawn even if the status line is
  7898.      currently turned off or sitting in a separate window.
  7899.  
  7900.    * When copying the contents of the screen to the clipboard `term'
  7901.      now converts alien IBM characters into ISO characters. This is a)
  7902.      required for the IFF FTXT format in which text gets stored in the
  7903.      clipboard and b) no longer causes invalid data to show up in the
  7904.      output stream when pasting the contents of the clipboard.  Put
  7905.      another way, in earlier releases the IBM style characters would go
  7906.      unmodified into the buffer. When pasting the clipboard contents,
  7907.      they would then get `converted' into IBM style characters as
  7908.      `term' always expected ISO characters to be found in the clipboard
  7909.      (garbage in -> even more garbage out). Nasty, isn't it?  Thanks go
  7910.      to Stephen Bowman for telling me about the problem.
  7911.  
  7912.    * Under some circumstances the text buffer would get the text font
  7913.      width all wrong, causing characters to be left behind when
  7914.      scrolling the page. This has been fixed.
  7915.  
  7916.    * Cleaned up gtlayout.library for release, window resizing now works
  7917.      a tad better, although the visual effects are not quite that
  7918.      striking. But then perhaps they are striking, which is why they
  7919.      haven't returned to work yet.
  7920.  
  7921.    * `term' also takes care of the screen size now when falling back to
  7922.      a usable screen mode. This should cure the notorious "half height
  7923.      screen" problem.
  7924.  
  7925.    * The cancel button now does what it should do in the date panel and
  7926.      the modem panel.
  7927.  
  7928.    * Changed the way how colours are assigned to drawing pens if the
  7929.      selected colours cannot be displayed. The previous method only made
  7930.      sure that there is no black text on a black background, the changes
  7931.      now also take care of white text on white background.
  7932.  
  7933.    * More changes to the XPR abort handling code; the first request to
  7934.      cancel the transmission while xpr_sread() is being executed now
  7935.      properly follows the rules of how to do things (it stops the read
  7936.      request prematurely and gives the protocol a chance to call
  7937.      xpr_chkabort() and to eventually find out what the user wanted).
  7938.      If you hit cancel again it will - as `term' used to do in previous
  7939.      releases - abort the read request, send a bunch of CAN characters
  7940.      and return with an error. Martin Berndt suggested this.
  7941.  
  7942.    * I know some of you won't like it, but the following settings
  7943.      editors are now `paged' to save much space: serial, modem, screen,
  7944.      terminal, emulation, capture and transfer. The nice thing about
  7945.      the new look is that it allows me to save on something else:
  7946.      cryptic abbreviations.
  7947.  
  7948.    * Discovered some old code left over from prehistoric program
  7949.      releases.  The local museum wasn't interested, so I just discarded
  7950.      it.  Unfortunately, the total program size did not drop sharply
  7951.      after I did so.
  7952.  
  7953.    * Whoops, the sound settings editor did not check for `empty' strings
  7954.      and could tell you that it was unable to locate the file "".
  7955.  
  7956.    * The picker button of the "Help file" text editing field in the path
  7957.      panel now does what it should do.
  7958.  
  7959.    * More changes to gtlayout.library, it now respects the window bottom
  7960.      border size gadget and allows the Tab key to be used for cycling
  7961.      through paged settings editors.
  7962.  
  7963.    * The clipboard and paths settings editors are now paged.
  7964.  
  7965.    * In paged settings editors, pressing the Tab key cycles through the
  7966.      pages.
  7967.  
  7968.    * Shortened the english friendly startup reminder message so it fits
  7969.      on NTSC screens.
  7970.  
  7971.    * When starting up for the first time, `term' no longer complains
  7972.      about missing DSR signals or notifies the user that RTS/CTS
  7973.      handshaking should be enabled. This is done in order to avoid
  7974.      confusion, the reminders and messages will follow later when the
  7975.      user makes the first changes and saves them to disk.
  7976.  
  7977.    * The XPR transfer window no longer warns about files not fitting on
  7978.      filing system which look suspiciously like ram disks, i.e. are not
  7979.      clearly identified as block mapped filing systems.
  7980.  
  7981. Changes introduced with v4.2:
  7982. *****************************
  7983.  
  7984.    * Did not set up serial parameter correctly (nasty, those typos!).
  7985.  
  7986.    * HydraCom could cause `term' to hang upon startup.
  7987.  
  7988.    * Increased the width of all the integer gadgets in the rates
  7989.      settings panel.
  7990.  
  7991.    * Incrementer arrows did not work properly in all settings panels,
  7992.      this was due to a bug in the SAS/C optimizer which caused
  7993.      gtlayout.library to run into trouble.
  7994.  
  7995.    * When called from the phonebook, the "Standard" button as shown by
  7996.      the translation table settings panel will cause the translation
  7997.      settings to be reset to standard values.
  7998.  
  7999.    * Text stored in the buffer did not get bit 7 stripped if this
  8000.      feature was enabled in the serial settings.
  8001.  
  8002.    * New look slider gadgets (requires gtlayout.library v5).
  8003.  
  8004.    * Numerous bug fixes in the user interface support library.
  8005.  
  8006.    * Rewrote the text buffer capture routines, there should no longer
  8007.      be extra, unwanted data in the buffer.
  8008.  
  8009.    * Fixed the overly wide incrementer arrow bug which caused so much
  8010.      trouble in previous releases.
  8011.  
  8012.    * Reloading the fast macros when making a new connection did not
  8013.      update the fast macro window.
  8014.  
  8015.    * In the area codes editor, creating a new entry and moving it
  8016.      around no longer leads to unexpected results.
  8017.  
  8018.    * There was a typo in the source code which prevented the EOL
  8019.      translation settings from getting changed via ARexx.
  8020.  
  8021.    * For a phonebook entry dialed, the startup and login macros are now
  8022.      executed in sequence rather than in parallel.
  8023.  
  8024.    * New capture settings options "Convert characters": if enabled
  8025.      along with the capture filter, text stored in the text buffer and
  8026.      the capture file will be converted into proper ISO characters.
  8027.      This effectively discards unprintable IBM font style characters.
  8028.      Note that this option will do nothing if you are using the standard
  8029.      text font rather than the IBM text font. Also keep in mind that
  8030.      this special text filter will always be enabled for printer
  8031.      captures in order to avoid nasty side-effects. The text and review
  8032.      buffers will no longer use the IBM PC style font if this option is
  8033.      in effect.
  8034.  
  8035.    * In the emulation settings you will find a new switch labeled "Lock
  8036.      wrapping" which will let you lock the current line wrapping mode
  8037.      so that application software and terminal resets will no longer
  8038.      modify it.
  8039.  
  8040.    * Added another two `lock' options. Now you can choose to lock the
  8041.      current text colour and the text rendering style. Take care, the
  8042.      `Reset styles' and `Reset terminal' options will no longer change
  8043.      colour and style once they are locked.
  8044.  
  8045.    * Made sure that interleaved screens work properly. They do now.  If
  8046.      you still see text scrolled or erased plane by plane you're either
  8047.      hallucinating or you have the PICASSO monitor driver installed
  8048.      which has the systemwide effect of making the operating system
  8049.      ignore requests to use interleaved bitmaps.
  8050.  
  8051.      Closer examination has revealed that the interleaved bitmap stuff
  8052.      did not work properly when using Kickstart v2.04. In fact,
  8053.      Kickstart v3.0 is the first operating system release which fully
  8054.      supports interleaved bitmaps for all graphics rendering calls.
  8055.      Previous releases did not take advantage of them, even if set up
  8056.      properly. Sorry folks, you won't be able to use this feature under
  8057.      Kickstart v2.04 any more: I removed the necessary support routines.
  8058.  
  8059.    * Added pen and text attribute translation. In the emulation
  8060.      settings you will find an option to select nonstandard pens.  In
  8061.      this case, these pens refer to the terminal emulation rendering
  8062.      pens and text attributes.
  8063.  
  8064.    * Tweaked the terminal emulation parser to swallow the Amiga
  8065.      specific commands to turn the cursor on or off (aSCR).
  8066.  
  8067.    * The device/library selection now also includes ROM-resident
  8068.      modules. At least one multiserial board includes a driver in its
  8069.      ROM rather than on disk. In older releases, this particular driver
  8070.      did not show up in the list, causing users to believe their boards
  8071.      to be damaged.
  8072.  
  8073.    * Changed the audio channel allocation priority. In previous program
  8074.      releases the channels could be stolen, causing `term' to hang or
  8075.      crash. Now it's DeliTracker to break down, not `term' ;-)
  8076.  
  8077.    * Cloning a phonebook entry did not duplicate the corresponding
  8078.      transfer settings. This has been fixed.
  8079.  
  8080.    * The serial settings now sport an additional OwnDevUnit control
  8081.      switch. You can now choose to ignore requests to release the
  8082.      serial device driver or to have the device released, causing
  8083.      `term' to check in intervals of 4 seconds if the device has become
  8084.      available again. The default behaviour (the device driver is
  8085.      released) is still supported.
  8086.  
  8087.    * There is another sound options, called `Error sound'. `term' will
  8088.      play this sound if a certain number of transfer errors have
  8089.      occured. The number of errors to occur can also be set in the
  8090.      transfer settings editor.
  8091.  
  8092.    * You can now select when the file transfer routines should notify
  8093.      you. You can be notified both at the beginning and the end of the
  8094.      transfer, just at the beginning, just at the end or even never.
  8095.  
  8096.    * The program no longer reports phone rates after losing a
  8097.      connection if there is no sensible data to report.
  8098.  
  8099.    * The "WAIT" command did apparently pay attention to the case of
  8100.      characters passed in when scanning the wait list for matching
  8101.      entries. This has been fixed.
  8102.  
  8103.    * For some strange reasons, the VT100 supplementary graphics
  8104.      character set never got loaded. This has been fixed.
  8105.  
  8106.    * Rewrote the status line display code (yet again). When running on
  8107.      a custom screen you probably won't see any difference, but: open
  8108.      `term' on a public screen and watch your system performance. No
  8109.      more deadlocks, no more sluggish mouse movements, no more CPU
  8110.      hogging. The display window is a bit larger, but this hopefully
  8111.      won't be a problem. After all, the window mode is usable now.  The
  8112.      old BOOPSI code is gone and will probably never return. The new
  8113.      code is in many ways quite a bit nicer than the old code. For
  8114.      example, it is synchronized with the window size changes. As soon
  8115.      as the terminal adapts itself to the new window size, so does the
  8116.      status line display.
  8117.  
  8118.    * The review buffer window text rendering colours would also get set
  8119.      to some value when opening the program on a custom screen. It now
  8120.      leaves the text colour untouched in this case.
  8121.  
  8122.    * The main window position is now saved along with the main settings.
  8123.  
  8124.    * Finally added the one-line chat text entry field which surely is
  8125.      no replacement for the packet window, but nevertheless I hope at
  8126.      least some folks will find it useful. No split-screen chat yet,
  8127.      sorry.
  8128.  
  8129.    * The `dial number' requester now remembers phone numbers between
  8130.      calls.
  8131.  
  8132.    * The quick dial menu now gets disabled if the modem is online.
  8133.  
  8134.    * The ASCII transfer menu items no longer get disabled if the
  8135.      internal transfer routines are selected and the XPR ascii transfer
  8136.      lib names are blank.
  8137.  
  8138.    * Updated the font selection code for text and review buffer
  8139.      displays. The review buffer now runs as a Process, so it can open
  8140.      disk resident fonts if it needs to.
  8141.  
  8142.    * Fixed a few bugs in the SETATTR ARexx command.
  8143.  
  8144.    * Auto-expanding control panels, such as the phonebook and the file
  8145.      transfer window no longer obscure the status line display.
  8146.  
  8147.    * The program now properly pays attention to the number of lines to
  8148.      use for the terminal display. Thanks go to Russ for his
  8149.      persistence ;-)
  8150.  
  8151.    * In monochrome mode text is no longer printed in inverse video mode.
  8152.  
  8153.    * The screen settings editor now allows you to change the colour
  8154.      mode even if `term' is running on a public screen.
  8155.  
  8156. Changes introduced with v4.1:
  8157. *****************************
  8158.  
  8159.    * Fixed an Enforcer hit in gtlayout.library caused by the text
  8160.      gadget handling code.
  8161.  
  8162.    * If possible child windows are now opened within the bounds of
  8163.      their parent windows.
  8164.  
  8165.    * Fixed an Enforcer hit caused by the ARexx interface building
  8166.      dialing lists.
  8167.  
  8168.    * Reordered the parameters of the "ADDITEM" ARexx interface command.
  8169.  
  8170.    * Rewrote the entire data capturing process. I somewhat opened a can
  8171.      of worms, making it necessary to rewrite the code that handles the
  8172.      translations for the "Receive CR as..." and "Receive LF as..."
  8173.      options as well. Careful please, although I am sure the code works
  8174.      correctly I may have knocked over some china cups.
  8175.  
  8176.    * Added some more safety catches to the upload queue handling.
  8177.      Using the auto-upload panel with the upload queue could leave you
  8178.      locked out, blocking `term'. Generally, not a very nice thing to
  8179.      do. Under the same conditions the code will now fall back to
  8180.      presenting the standard file requesters.
  8181.  
  8182.    * Fixed a bug in the capture panel which could turn up if the editor
  8183.      was invoked from the phonebook.
  8184.  
  8185.    * Corrected some few typos in the english user interface text.
  8186.  
  8187.    * Turning off script recording did not reset the program status to
  8188.      `ready'. This has been fixed.
  8189.  
  8190.    * Heaven knows why, but v4.0 did not permit changing the screen
  8191.      colours if running in monochrome mode.
  8192.  
  8193.    * The `Freeze buffer' menu now properly toggles the state of the
  8194.      capture buffer.
  8195.  
  8196.    * The terminal settings now take the maximum possible values into
  8197.      account when setting the selection ranges for the number of
  8198.      columns and lines.
  8199.  
  8200.    * When using a startup script or a startup command the program no
  8201.      longer displays its `about' window on program startup.
  8202.  
  8203.    * The ARexx command "GOONLINE" now sets up some more of status
  8204.      variables than it used to do in v4.0.
  8205.  
  8206.    * Upon startup the carrier signal is checked (provided your serial
  8207.      configuration says that the carrier should be checked) and if it
  8208.      is present the online timer is started.
  8209.  
  8210.    * Added a bunch more of serial baud rates. Don't overdo it, a
  8211.      standard Amiga won't go faster than 115K baud.
  8212.  
  8213.    * Replaced the serial rate slider with an integer gadget featuring
  8214.      incrementer arrows. Clicking on the arrows will cycle through all
  8215.      standard baud rates. Note: requires gtlayout.library 1.97 or
  8216.      higher.
  8217.  
  8218.    * When offline detecting a carrier signal will bring `term' into
  8219.      online state, provided the `Check carrier' flag is enabled in the
  8220.      serial settings.
  8221.  
  8222.    * ^Q now works again.
  8223.  
  8224.    * The end-of-line character translation scheme was changed into one
  8225.      single unified concept. Both carriage return and line feed
  8226.      characters can now be translated into <cr>, <lf>, <lf><cr>,
  8227.      <cr><lf> or can be ignored.
  8228.  
  8229.    * The phone rates management is moving from the individual phone
  8230.      book entries into a separate global settings editor.  The old
  8231.      rates management style will continue to work, but the new
  8232.      management scheme has priority over it.
  8233.  
  8234.      Here is how the new scheme works: you now assign the rates
  8235.      accounting data to area codes rather than to single phone book
  8236.      entries. Suppose you want a special set of rates settings to be
  8237.      used for all phone book entries and phone numbers which start with
  8238.      the area code "009". In this case you would add another group
  8239.      entry, assign a name to it and put "009#?" into the pattern field.
  8240.      The next time `term' makes a connection to a phone number starting
  8241.      with the digits "009" the corresponding rates settings will be
  8242.      used. `term' scans the list top-down, so the default settings
  8243.      should be put into the last list entry.  The patterns follow the
  8244.      AmigaDOS syntax.
  8245.  
  8246.    * Finally discovered why so many old phonebook files would cause
  8247.      trouble: the internal conversion routine was *never* called.
  8248.  
  8249.    * Horrors! The sound.datatype saves invalid sound files with the
  8250.      playback size set to zero, causing `term' to crash with a
  8251.      `division by zero' error. The replay routine now handles such odd
  8252.      files.
  8253.  
  8254.    * The sliders for redial delay and time to connect now finally sport
  8255.      a resolution of a single second rather than ten seconds.
  8256.  
  8257.    * Shortened gadget labels & texts and rearranged the gadget layout
  8258.      to make sure all windows will fit on a plain 640 x 400 sized screen
  8259.      with topaz/8. Sorry folks, 640 x 200 is right out of the question.
  8260.      These are the days of miracle and wonder and all modern Amiga
  8261.      hardware is capable of displaying screens this size in
  8262.      non-interlaced modes.  If things still don't seem to fit try a
  8263.      different font, preferably proportional-spaced, or a different
  8264.      screen resolution (change the overscan size if necessary).
  8265.  
  8266.    * Whilst reworking the documentation discovered that I forgot to add
  8267.      the `Alert' control to the terminal panel.
  8268.  
  8269.    * With Workbench v2.04 the screen mode requester automatically
  8270.      resets the screen size and overscan values to defaults.
  8271.  
  8272.    * The text buffer search requester now sports another option, "Whole
  8273.      words only".
  8274.  
  8275.    * The jump scroll option code had a control switch set in the `wrong
  8276.      direction'. Nothing serious, `term' would only scroll too many
  8277.      lines.
  8278.  
  8279.    * The jump scrolling routines did not take the size and position of
  8280.      the currently active scroll region into account. This could knock
  8281.      out the emulation since the cursor could cross the legal position
  8282.      limits.
  8283.  
  8284.    * Added some more control key codes as per the VT 220 Programmer
  8285.      Pocket Guide, such as ^2, ^3, ^4, ^5, ^[, ^/, ^].
  8286.  
  8287.    * Fixed another bug that would cause `term' to busy loop if it
  8288.      stumbled upon a non-printable character in IBM PC style font mode.
  8289.  
  8290.    * `term' now supports context-sensitive help with AmigaGuide v34.  I
  8291.      finally discovered a set of AmigaGuide commands that would not
  8292.      crash when told to change the currently displayed context.
  8293.  
  8294.    * Changing XEM options will save them back to disk.
  8295.  
  8296.    * Rewrote the hangup/carrier lost/online/offline handling procedure.
  8297.      The online/offline status tracking is protected by semaphores now,
  8298.      the code to modify the status was reduced to a great deal, it's
  8299.      only in termDial.c, termARexxCommands.c and in termMain.c. The
  8300.      hang up command and carrier lost actions now go through the same
  8301.      code, i.e. backup config & redial on logoff now work both for
  8302.      logoff & hangup.
  8303.  
  8304.    * The phone rates accounting by area codes did not work since the
  8305.      routines were commented out. I removed the comments, they should
  8306.      work now.
  8307.  
  8308.    * The buffer management no longer collapses if you try to clear the
  8309.      contents while there is still data coming in.
  8310.  
  8311.    * Reread the "VT 220 Programmer Pocket Guide" and added most of the
  8312.      remaining unsupported control sequences. Not supported are the
  8313.      programmable function keys and data transfers bracketed by
  8314.      DCS..ST. A number of control sequences are still no-ops, such as
  8315.      the national/multinational font support operations.
  8316.  
  8317.    * Double-clicking on a phonebook entry with no phone number attached
  8318.      no longer starts dialing.
  8319.  
  8320.    * Changed numeric keypad applications mode and PF key handling.  I
  8321.      hope it works with all keymappings now.
  8322.  
  8323.    * Cloning a rates settings entry did not properly duplicate all data
  8324.      associated with the original entry.
  8325.  
  8326.    * Creating a new phonebook entry will set the rates accounting data
  8327.      connected with it to zeroes.
  8328.  
  8329.    * Rewrote the prescrolling/jump scrolling support code which now
  8330.      should get the job more quickly than before.
  8331.  
  8332.    * Resetting the terminal emulation no longer clears the state of the
  8333.      `Wrap cursor moves' option.
  8334.  
  8335.    * Rewrote and simplified serial I/O processing, I hope it still
  8336.      works.
  8337.  
  8338.    * Dialing commands no longer make it into the text buffer.
  8339.  
  8340.    * The `Cancel' button in the phonebook panel was relabeled, now
  8341.      showing `Use' instead.
  8342.  
  8343.    * The program no longer puts the upload queue icon into the Workbench
  8344.      window by default, there is a new option to turn it off.
  8345.  
  8346.    * You can finally edit all the settings to be changed in the
  8347.      phonebook, this includes function keys, cursor keys, translation
  8348.      tables and fast macros. Hold down either shift key to bring up the
  8349.      old file requesters. Note that you will also get the old file
  8350.      requesters if something goes wrong reading and setting up the
  8351.      settings data.
  8352.  
  8353.    * Added an option to make a hardcopy of the screen contents, invoking
  8354.      the printer graphics dump function.
  8355.  
  8356.    * All the windows sporting pull-down menus now support menu help,
  8357.      i.e.  if you press the help key while a menu item is being
  8358.      selected `term' will bring up the online help page for the
  8359.      corresponding menu.
  8360.  
  8361.    * Duplicating a phonebook entry now properly duplicates the
  8362.      corresponding rates settings.
  8363.  
  8364.    * Added new keyboard shortcuts to the phonebook controls. Pressing
  8365.      `Del' untags the currently selected entry, `Shift+Del' untags all
  8366.      entries.
  8367.  
  8368.    * `term' now looks up the "Fonts" and "Libs" drawers in the current
  8369.      directory and adds them to the "Fonts:" and "Libs:" assignment
  8370.      list.  At least for me, this greatly simplifies the installation
  8371.      procedure.  Just copy the contents of all distribution archives
  8372.      into a single drawer and let `term' do the rest.
  8373.  
  8374.    * The fast! macro button list now properly responds to Alt+Amiga key
  8375.      clicks. I also thinned out the code a bit, causing the buttons to
  8376.      render a little faster.
  8377.  
  8378.    * Relabeled the button in the bottom left corner of the phonebook
  8379.      window again. It now reads "Close".
  8380.  
  8381.    * The buffer search requesters are now non-modal so you can have them
  8382.      open and continue to use the text buffer display.
  8383.  
  8384.    * I reworked some parts of the user interface, trying to clarify the
  8385.      functions of menus and buttons. I also removed some redundant
  8386.      button labels and changed all references to `directories' to
  8387.      `drawers'.
  8388.  
  8389.    * Shortened the button labels for the phonebook and the rate panel,
  8390.      so they will finally fit on a 640 x 400 screen using topaz/8.
  8391.      Some button labels now look fairly obscure, sorry about that.  I
  8392.      guess I'll rething the part about the "clarification" again...
  8393.  
  8394.    * More weird & wonderful changes to the serial device interface
  8395.      code. I hope it still works.
  8396.  
  8397.    * When hanging up the line using the corresponding menu command the
  8398.      online state is no longer reset to `offline' if in the serial
  8399.      settings the "Check carrier" feature is enabled. This leaves the
  8400.      test for the carrier to the usual routines which will detect if
  8401.      the carrier is really gone.
  8402.  
  8403.    * With multi-number phonebook entries the dialer now displays how
  8404.      many of these numbers have been dialed already.
  8405.  
  8406.    * There was something really wrong with the way clipboard text was
  8407.      pasted as the `end of line' character conversion would be applied
  8408.      twice.
  8409.  
  8410.    * The "Time to connect" data was never used for phone rates
  8411.      accounting, it only played a minor role in the "Connect limit"
  8412.      settings.
  8413.  
  8414.    * The pop-up `About' window no longer is GimmeZeroZero, which is
  8415.      both sexy and uses less memory.
  8416.  
  8417.    * Beep & action sounds are now loaded via datatypes if available.
  8418.      Under v39 this may not work well for large sound files due to a
  8419.      bug in sound.datatype. Plain IFF-8SVX format sound files will
  8420.      still be played using the built-in routines since they are more
  8421.      flexible than sound.datatype and can replay stereo sound.
  8422.  
  8423.    * Non-standard-sized system imagery (sizing gadgets, arrow gadgets,
  8424.      etc.) is now supported whereever it is used.
  8425.  
  8426.    * The phonebook window no longer sports a `Close' button, all that's
  8427.      left is the `Dial...' button.
  8428.  
  8429.    * Phonebook entries which lack a phone number can no longer be used
  8430.      for the dialing list.
  8431.  
  8432. Changes introduced with v4.0:
  8433. *****************************
  8434.  
  8435.    * The window status line is no longer `misplaced' under Kickstart
  8436.      v2.x.
  8437.  
  8438.    * Font, file and screen requesters are no longer quite so tiny.
  8439.  
  8440.    * Different font scales as by the VT100 specs (half width, double
  8441.      width, top double size, bottom double size) work again.
  8442.  
  8443.    * All memory allocations now go through memory pools, reducing
  8444.      memory fragmentation greatly. Note: Kickstart 3.x owners *should*
  8445.      have SetPatch 40.16 installed as the memory pool code might have
  8446.      trouble freeing empty memory pools until the program exits.  This
  8447.      memory allocation scheme should also help to get `term' to work
  8448.      with certain virtual memory system extensions.
  8449.  
  8450.    * In the XPR transfer window the error/message list will no longer
  8451.      hold more than 100 entries in order to save memory. I have received
  8452.      reports of users who ran large file transfers overnight and when
  8453.      getting up in the next morning the transfer error/message list had
  8454.      accumulated so much memory it was no longer possible to move the
  8455.      mouse: Intuition was unable to allocate enough memory to create new
  8456.      input events. If 100 messages have accumulated and a new one is
  8457.      about to be added the first and oldest entry will be removed.
  8458.  
  8459.    * The status line display now properly reflects the name of the
  8460.      current file transfer protocol.
  8461.  
  8462.    * The quick dial menu checkmarks would get cleared only on some rare
  8463.      occasions, i.e. if the first phonebook entry had the `Quick dial
  8464.      menu' feature set. Now it gets the job done no matter which
  8465.      phonebook entry is the first one in the quick dial menu.
  8466.  
  8467.    * The main window menus used to have the command shortcut `W'
  8468.      assigned twice.
  8469.  
  8470.    * If running on the Workbench dropping icons on the `term' window
  8471.      would ask for the type of file transfer (text or binary), but it
  8472.      would get the selection wrong, i.e. if you chose text you got a
  8473.      binary upload and the other way round. This has been fixed.
  8474.  
  8475.    * When in zoomed state the XPR transfer window will display the name
  8476.      of the file currently being transferred and how much of it has
  8477.      already been transferred (if available). This display will be
  8478.      updated about once a second.
  8479.  
  8480.    * If icons are to be created for files downloaded it is no longer
  8481.      necessary to turn on file type identification to actually get the
  8482.      icons attached.
  8483.  
  8484.    * Freezing the text buffer contents now properly updates the text
  8485.      processing routine variables.
  8486.  
  8487.    * Calling the `Print clipboard' function twice will no longer result
  8488.      in a general system lockup.
  8489.  
  8490.    * The double-buffered I/O routines now let you configure the buffer
  8491.      size to use. The memory allocation also is a lot more `forgiving'
  8492.      than it used to be: if necessary it will shrink the buffer size
  8493.      until it can allocate enough space.
  8494.  
  8495.    * To keep naughty applications from switching the cursor key and
  8496.      numeric keymap into applications mode you can lock both key sets
  8497.      now, so they will not to change their current modes.
  8498.  
  8499.    * The old AmigaGuide release (v34 to be accurate) is supported now,
  8500.      but with limited functionality. The help text is not context
  8501.      sensitive and you need to shut down the AmigaGuide server manually
  8502.      (by closing the AmigaGuide window) if the screen its window
  8503.      resides upon is to be closed.
  8504.  
  8505.    * `RING' and `CONNECT' messages from the modem are now reported
  8506.      along with the time when they came in.
  8507.  
  8508.    * The program now complains loudly about outdated catalog files and
  8509.      incorrectly installed locale.library.
  8510.  
  8511.    * The hotkey settings panel now checks each hotkey description text
  8512.      after it is entered and complains if it is unuseable.
  8513.  
  8514.    * The `QUIET' command line option (makes `term' start up iconified)
  8515.      no longer crashes if Workbench isn't running.
  8516.  
  8517.    * The program now features an all-new user interface.
  8518.  
  8519.    * There is a new command line option called `BEHIND' which causes
  8520.      the main screen to stay in the background and the main window not
  8521.      to become active upon startup.
  8522.  
  8523.    * If `term' fails to open a screen and finds out that the requested
  8524.      screen display mode is unavailable it will copy the screen mode
  8525.      the default public screen is in and retry.
  8526.  
  8527.    * No more trouble with mixed-case device and library names.  As you
  8528.      pick them from the list the files are validated, i.e.  `term'
  8529.      tries to load the file in question and hunts for the
  8530.      library/device resident tag included. If the tag is found the
  8531.      `real' device/library name is copied from it, replacing the
  8532.      original name the file was opened with. This means that you can
  8533.      select `XPRZModem.Library' using the file requester and `term'
  8534.      will look into the file to find out that the library wants to be
  8535.      opened under the name of `xprzmodem.library'.  Also included are a
  8536.      type check (i.e. if a library is to be opened only files with a
  8537.      library type resident tag are included in the list) and a brief
  8538.      name comparison (i.e. only name case differences are allowed, so
  8539.      `XPRZModem.Library' = `xprzmodem.library', but `foo.device' !=
  8540.      `bar.device').
  8541.  
  8542.    * The external emulation and the external protocol support routines
  8543.      no longer share the same code and the same set of error
  8544.      messages/options texts.
  8545.  
  8546.    * A transfer protocol such as xprkermit.library will no longer leave
  8547.      `term' in a `half-dead' state if it opens a new window in the
  8548.      protocol setup phase. In previous releases this window was never
  8549.      closed.
  8550.  
  8551.    * The label text of XPR/XEM command options which accept a parameter
  8552.      and thus cause the settings window to be closed after text is
  8553.      entered is now drawn in the current highlight colour. This helps
  8554.      to distinguish regular string gadgets and command option
  8555.      parameters.
  8556.  
  8557.    * If `term' fails to set up the XPR protocol properly, i.e.  the
  8558.      setup routine does not flag success, the library is closed right
  8559.      away. This is how it has always been in previous `term' releases.
  8560.      But this time the main menu is also updated to keep you from
  8561.      starting a file transfer or changing the transfer options while
  8562.      the library base pointer is invalid.
  8563.  
  8564.    * In order to support external protocols which write data to or read
  8565.      data from the serial line serial I/O processing is temporarily
  8566.      disabled while the corresponding setup routines are running.
  8567.      Although this behaviour isn't quite that nice it should avoid
  8568.      serious trouble with xprkermit.library which could otherwise
  8569.      disrupt the serial device request queue.
  8570.  
  8571.    * There are now three buttons in the file transfer panel which
  8572.      correspond to different abort levels:
  8573.  
  8574.      * Skip current file   Skips just the file currently being in
  8575.      transfer (level 2)
  8576.  
  8577.      * Stop transfer batch   Cancels the entire batch transfer (level 1)
  8578.  
  8579.      * Stop entire transfer   Emergency stop (level -1)
  8580.  
  8581.      These abort levels are supported by xprkermit.library and a number
  8582.      of other file transfer protocols.
  8583.  
  8584.    * Opening the transfer protocol settings editor will cause the
  8585.      currently selected default XPR protocol to be reopened in case it
  8586.      is not open yet.
  8587.  
  8588.    * Holding down the control key and clicking with the mouse on a
  8589.      space character will now correctly send it.
  8590.  
  8591.    * Double-clicking on a phonebook entry will no longer start dialing
  8592.      if the program is still online, i.e. if the regular `Dial' button
  8593.      is disabled.
  8594.  
  8595.    * If the line is hung up or the carrier is lost the call log file
  8596.      (human readable, not the one that is intended for postprocessing
  8597.      using call log analyzers) will include the costs for the call. In
  8598.      previous releases `term' would only look for the `NO CARRIER'
  8599.      message.
  8600.  
  8601.    * The destructive backspace option now removes the character to the
  8602.      left of the cursor but does not move the rest of the line one step
  8603.      to the left. This makes the terminal emulation behaviour more
  8604.      consistent with how real video terminals handle this job.
  8605.  
  8606.    * The translation table settings panel now features a `Default'
  8607.      button which resets the current translation settings to defaults.
  8608.  
  8609.    * Just like the text buffer screen the review buffer window is
  8610.      handled by a coprocess now.
  8611.  
  8612.    * The packet window now supports function keys.
  8613.  
  8614.    * For technical reasons I dropped the string gadget clipboard
  8615.      support. I suggest that you use StringClip or a similar program
  8616.      instead.
  8617.  
  8618.    * Clipboard pasting from the review buffer window no longer requires
  8619.      that you activate the main window.
  8620.  
  8621.    * In the phonebook the edit list (right hand side listview display)
  8622.      indicates whether an entry uses default settings or whether it
  8623.      actually uses custom settings. Custom settings are indicated by
  8624.      asterisks (`*').
  8625.  
  8626.    * The packet window now uses the current terminal text font.
  8627.  
  8628.    * Pressing Amiga+- in the packet window no longer transmits the
  8629.      current string but changes to the main window while leaving the
  8630.      current string intact.
  8631.  
  8632.    * Fixed a potential bug in the generic list management module.
  8633.  
  8634.    * With some file requester patches installed, such as old ReqTools
  8635.      or MFR, the file requester code could fail to notice if a single
  8636.      file was selected in multiselect mode.
  8637.  
  8638.    * The phone rates are now reported according to the current locale
  8639.      settings, i.e. they take the grouping and special attributes of
  8640.      the local currency into account.
  8641.  
  8642.    * The IFF-8SVX sound file player code now handles stereo and
  8643.      compressed sound files gracefully (all flavours including
  8644.      uncompressed stereo, compressed stereo, uncompressed mono and
  8645.      compressed mono).
  8646.  
  8647.    * The ARexx `WAIT' command could fail to report how many characters
  8648.      it pulled from the data stream when a matching string was found.
  8649.      This could result in random characters showing up in the terminal
  8650.      text output.
  8651.  
  8652.    * The routine to attach the wait mouse pointer to windows and to
  8653.      block input to them was easily losing track of its nesting count.
  8654.      In theory the nesting count could have wrapped around, locking you
  8655.      out. The harmless side-effect was that sometimes windows would not
  8656.      get blocked.
  8657.  
  8658.    * The ARexx `WAIT' command argument and the wait list may include
  8659.      control sequences now. These are expanded as soon as they go into
  8660.      the list. This feature makes it possible to wait for sequences
  8661.      such as `login:\rpassword\r' but will return result strings which
  8662.      include control characters, so watch out!
  8663.  
  8664.    * The ARexx `READ' command now allows you to combine the `CR' and
  8665.      `NUM' options. Also, the maximum number of characters to read with
  8666.      the `CR' option is no longer limited to 255 characters.
  8667.  
  8668.    * The file transfer window will at startup display the name of the
  8669.      currently selected transfer protocol. It displays a default value,
  8670.      leaving the protocol identification to the XPR library.
  8671.  
  8672.    * The ARexx `GETATTR' command would run into serious trouble if told
  8673.      to put information into a stem variable. The result would be
  8674.      Enforcer hits or crashes.
  8675.  
  8676.    * If you put `term' into iconified state and press the hotkey
  8677.      combination to bring its screen to the front you will no longer
  8678.      get an Enforcer hit. Instead `term' will exit its iconified state
  8679.      and return to normal action.
  8680.  
  8681.    * The status line display now coexists much nicer with MagicMenu and
  8682.      the like.
  8683.  
  8684.    * The status line no longer displays what text mode the terminal
  8685.      window is in (this was rather a silly feature) but rather if the
  8686.      text buffer is currently recording or if it's frozen.
  8687.  
  8688.    * The status line looks a bit different now (there is a proper
  8689.      separation bar now instead of the hair line).
  8690.  
  8691.    * Just like the v3.0 preferences palette editor `term' now permits
  8692.      to select the screen rendering pens. This will *not* work under
  8693.      v2.04 since gadtools.library v37 cannot handle it (actually it
  8694.      can, but the default glyphs do not support it). This feature
  8695.      permits you to change the screen colours while you can still keep
  8696.      the window new look.
  8697.  
  8698.    * The ARexx `READ' command could return random characters since the
  8699.      return buffer was not set up correctly.
  8700.  
  8701.    * Both the ARexx `READ' and `WAIT' commands now allow you type text
  8702.      on the local console and have it sent across the line. As for the
  8703.      `WAIT' command this is of great help if the script `hangs'. Note:
  8704.      halting scripts and and such still requires pressing the `Shift +
  8705.      Shift + Esc' key combination.
  8706.  
  8707.    * The ARexx `READ' command would, if used with the `NUM' option,
  8708.      always return a NULL-terminated string, no matter what kind of
  8709.      data came in. It now returns the entire amount of data
  8710.      transferred, including NULL-bytes.
  8711.  
  8712.    * The phonebook list now clearly shows which entries are selected
  8713.      for dialing and which are not (it flips the background and text
  8714.      colours). Note: this works only with Kickstart 3.0 and above.
  8715.  
  8716.    * I increased the possible number of dial retries in the modem panel
  8717.      to 1000. In addition to that you can set the number of dial
  8718.      retries to `unlimited' now.
  8719.  
  8720.    * For those nasty MS-DOS based file transfer protocols which choke on
  8721.      file names longer than 12 characters (eight for the name, one for
  8722.      the dot, three for the extension) the file transfer options now
  8723.      permit to have filenames shrunken before they are handed to the
  8724.      transfer protocol. Internally, the XPR interface will still refer
  8725.      to the file under its original name. The routine responsible for
  8726.      shrinking the file names also takes care of the extension
  8727.      separator dot. If there is more than one dot in the file name all
  8728.      the others get replaced by underscore characters. Also, if there
  8729.      is no dot extension it will be added.
  8730.  
  8731.    * The packet window is handled by a coprocess now.
  8732.  
  8733.    * If you're bold and daring you can make `term' handle the terminal
  8734.      output on the schedule of a terminal emulation task.  Please note
  8735.      that this requires additional memory and will slow down the
  8736.      emulation if your memory is fragmented. But on the other hand the
  8737.      coprocess will stop serial input getting munged before it arrives
  8738.      in the terminal emulation output buffer. Such things can happen
  8739.      with systems which experience heavy DMA bus or task loading
  8740.  
  8741.    * Turning on the `faster layout feature' no longer drops the screen
  8742.      & window newlook.
  8743.  
  8744.    * Due to an oversight the terminal emulation process could get
  8745.      enabled even when using an external emulation, this has been fixed.
  8746.  
  8747.    * The ARexx command `SENDFILE' would never remove the names of files
  8748.      transferred from the upload list.
  8749.  
  8750.    * Yet another new option: by default the dialer sends a `\r' string
  8751.      when skipping an entry and when hanging up the line. You can
  8752.      change this behaviour via the `Dialer abort hangs up' option now.
  8753.      If enabled the dialer will go through the routine hang up
  8754.      procedure (dropping the DTR signal, sending the hangup string, you
  8755.      name it). This should convince even the most stubborn modems to
  8756.      stop doing what they are currently thinking to be fun and to
  8757.      return to normal operation.
  8758.  
  8759.    * Clicking on the main window in order to activate it will no longer
  8760.      trigger the character snapping function.
  8761.  
  8762.    * Rewrote the ARexx `WAIT' routine to a great deal. It could easily
  8763.      forget to turn serial input processing back on for the main
  8764.      program. After a script would exit you would get stuck with data
  8765.      coming in from the serial line, but none of it would be displayed
  8766.      or worked upon.
  8767.  
  8768.    * Clicking on the text buffer screen window in order to activate it
  8769.      will no longer trigger the character snapping function. Since
  8770.      there is no safety catch, i.e. the clipboard contents are
  8771.      immediately replaced by what you selected after you let go of the
  8772.      mouse button, this will reduce the chance of losing your current
  8773.      clipboard contents.
  8774.  
  8775.    * Subtle change in the dialer procedure: if an entry would use the
  8776.      default serial settings they did not replace the current serial
  8777.      settings, even if the previous dial list entry had altered them.
  8778.      However, the original purpose of the default settings was to use
  8779.      the unmodified global settings. The dialer behaviour now respects
  8780.      this, changing the current serial settings back to the global
  8781.      settings, not keeping the changes the previous dial list entry had
  8782.      made.
  8783.  
  8784.    * In previous program releases trying to make certain phonebook
  8785.      entries not use the default settings was somewhat difficult: you
  8786.      had to change the corresponding settings entries to something
  8787.      different from the global defaults. Things are much easier now,
  8788.      just open the settings editor and click on the `Use' button.
  8789.  
  8790.    * The `Startup/Login macro' has been split into a startup macro and a
  8791.      login macro. The dialing routine will first invoke the login macro
  8792.      and then the startup macro. Only the dialing routine makes use of
  8793.      the login macro.
  8794.  
  8795.    * Small cosmetic changes to the user interface code: cycle gadgets
  8796.      are a few pixels wider now in order to keep `CycleToMenu' happy.
  8797.  
  8798.    * When hanging up the line the logoff macro was never executed.
  8799.  
  8800.    * Finally discovered why the serial read quantum and all the
  8801.      scheduled events were never processed again once they reported
  8802.      that no further data was available. Now the event response loop
  8803.      updates the signal mask again when it reaches the bottom of the
  8804.      loop to see if any new data came in.
  8805.  
  8806.    * You can now configure the screen depth, permitting to use the
  8807.      Picasso II chunky display mode with `term'. Note: asl.library
  8808.      v38-v40 fails to handle nonstandard background pen colours
  8809.      correctly, i.e. the depth slider text may be illegible.
  8810.  
  8811.    * External emulation libraries, namely xemvt340.library, should work
  8812.      again. I changed the memory allocation call for the XEM support
  8813.      interface, but I have no idea why it did the trick.
  8814.  
  8815.    * The status window is handled by a coprocess now.
  8816.  
  8817.    * Some ARexx interface commands now run asynchronously.
  8818.  
  8819.    * Yet another visual gimmick (sorry, couldn't resist): menu
  8820.      checkmarks and Amiga keys are now scaled according to the current
  8821.      screen display ratio. Note: not really compatible with utilities
  8822.      such as MagicMenu or Silicon Menus. Although the programs will run
  8823.      the menu layout may look odd.
  8824.  
  8825.    * The phonebook list can be scrolled with cursor keys now. You also
  8826.      get a visual feedback if running under Kickstart 3.x.
  8827.  
  8828.    * Fixed a nasty bug in the user interface code to pick the gadget
  8829.      shortcuts: it would prefer to pick the last letter of gadget
  8830.      labels and ignore any preceding letters.
  8831.  
  8832.    * Scrolling lists such as the phonebook list will size-adapt to the
  8833.      screen `real estate' available.
  8834.  
  8835.    * The screen settings now give you full access over display overscan
  8836.      mode and screen dimensions. Note that asl.library v38 or higher is
  8837.      required to use these features.
  8838.  
  8839.    * Changed the cursor key control in listviews, making it possible to
  8840.      use the Shift/Alt/Control qualifier keys in Style Guide compatible
  8841.      fashion.
  8842.  
  8843.    * Rewrote certain dos.library related parts of the user interface
  8844.      code, permitting plain tasks to call the routines. Consequently, a
  8845.      number of coprocess-driven routines was rewritten to run on the
  8846.      schedule of a task. Note: this may conflict with the ChangeScreen
  8847.      utility included in the Picasso II distribution.
  8848.  
  8849.    * Old style XPR settings entered using the old style prefs interface
  8850.      (i.e. those that would pop up a text entry requester) were never
  8851.      saved.
  8852.  
  8853.    * The transfer library selection panel now allows you change the
  8854.      settings of all selected protocols, you no longer need to select
  8855.      all individual protocols as the default protocol and invoke the
  8856.      `Protocol settings...' menu function on them.
  8857.  
  8858.    * The text and review buffer search requesters maintain backlogs of
  8859.      the previous search patterns now (use the cursor keys to scroll
  8860.      through the patterns). Use the capture settings to change the
  8861.      number of patterns to keep.
  8862.  
  8863.    * The text buffer search function no longer enforces a
  8864.      case-insensitive search.
  8865.  
  8866.    * Most time and date displays now use the current locale settings.
  8867.      It did not make sense to make all such displays use this text
  8868.      formatting scheme. All remaining displays will use the common dos
  8869.      date/time formatting parameters.
  8870.  
  8871.    * Modified OwnDevUnit.library support: if another task wants to gain
  8872.      access to the locked device `term' will release it unless the
  8873.      modem is still online. The device is released by calling the
  8874.      `Release serial device...' menu entry.
  8875.  
  8876.    * Oops... the XPR options editing code did not flag changes in
  8877.      numeric arguments to the main program. Also, old style XPR options
  8878.      were always reported as `changed'.
  8879.  
  8880.    * Not all memory allocations went through memory pools, this has
  8881.      been fixed.
  8882.  
  8883.    * The `Printer control enabled' switch was omitted from the
  8884.      emulation panel, sorry about that.
  8885.  
  8886.    * Some windows would not be moved into the foreground when opened,
  8887.      so you had to play `hide and seek' to see on which screen they
  8888.      appeared.
  8889.  
  8890.    * With display aspect ratios that aren't even remotely square
  8891.      incrementer arrows for integer gadgets are no longer larger than
  8892.      their container boxes.
  8893.  
  8894.    * The program no longer crashes if the XPR protocol feels about
  8895.      displaying a message before any other window is open.
  8896.  
  8897.    * By public demand the highlighting scheme in the phonebook window
  8898.      was changed to yield better contrast.
  8899.  
  8900.    * The speech volume is given in percent now, but the ARexx interface
  8901.      `GETATTR' command did not reflect this.
  8902.  
  8903.    * The sound settings now sport a volume slider which affects all
  8904.      sounds played. Suppose a sound is to be played at maximum volume,
  8905.      i.e. 64 for the current Amiga hardware and the volume slider is set
  8906.      to 25%, then the sound will be played at volume level 16. Setting
  8907.      the volume slider to 0 will cause `term' not to produce any sound.
  8908.  
  8909.    * The transfer panel message list dimensions are now auto-adjusted
  8910.      to the screen size. The layout code also tries hard not to make the
  8911.      window overlap the status line.
  8912.  
  8913.    * Added some bells & whistles to the phonebook window. I hope it
  8914.      still works.
  8915.  
  8916.    * Moved the user interface code into a shared library in order to
  8917.      make things more complicated.
  8918.  
  8919.    * The OwnDevUnit feature is no longer linked to the `Shared access'
  8920.      option.
  8921.  
  8922.    * All sounds are now replayed in the same fashion as the bell sound,
  8923.      i.e. if a sound is currently being played a request to play
  8924.      another sound will not be satisfied.
  8925.  
  8926.    * Important file transfer notification messages are now printed in
  8927.      the current highlight colour.
  8928.  
  8929.    * The destructive backspace mode now offers three choices: off,
  8930.      overstrike and shift. Overstrike mode clears the character below
  8931.      the cursor and shift mode will shift the line contents to follow
  8932.      the cursor to the left.
  8933.  
  8934.    * The screen panel now features some more options which permit to
  8935.      open the main window on a custom screen as though it were a public
  8936.      screen and an option to split the status line from the main window.
  8937.  
  8938.    * Tried to squeeze some space out of the control panels with mixed
  8939.      results.
  8940.  
  8941.    * The text buffer screen no longer uses the main screen display mode
  8942.      by default, it is possible to select the display mode now.
  8943.  
  8944.    * The built-in ASCII file transfer routines no longer draw upon the
  8945.      current clipboard settings to determine how to send and receive
  8946.      text. There is an all-new preferences editor for this purpose now.
  8947.  
  8948.    * Added an upload list editor, permitting to collect the files to be
  8949.      transmitted in a list before the transfer is started.  You can
  8950.      enter the file names, drop icons on the editor window or on the
  8951.      AppIcon. When you are finished, just press the upload button.
  8952.  
  8953.    * The packet window string gadget now has room for more than 1000
  8954.      characters. Note: the `Load history' command only supports 255
  8955.      characters per line.
  8956.  
  8957.    * Added a prescroll option to the emulation settings. The system is
  8958.      not very smart but should get the job done rather quickly; if the
  8959.      cursor is positioned on the last terminal line the number of line
  8960.      feeds in the input data stream is counted. The number of line
  8961.      feeds or the max.prescroll number (whatever is smaller) will
  8962.      determine how many lines to scroll the screen contents up.
  8963.  
  8964.    * With an empty phonebook loading a new phonebook file would not
  8965.      enable the phonebook list, this has been fixed.
  8966.  
  8967.    * Added another option to complement the prescroll settings. Testing
  8968.      revealed that the conditions leading to the prescroll feature to
  8969.      be used were met only rarely. The `max. jump' option will give you
  8970.      roughly the same functionality as the `max. prescroll' option, the
  8971.      difference is in the handling of the input data stream: the
  8972.      prescroll option counts the number of line feeds, the jump option
  8973.      only looks for a single line feed and then scrolls up the screen
  8974.      the given number of lines.
  8975.  
  8976.    * The program now remembers the window position and size before going
  8977.      into iconified state. When the window is reopened it will reappear
  8978.      at the position and in the size remembered
  8979.  
  8980.    * The ARexx `ADDITEM' command supports a new keyword `RESPONSE' to be
  8981.      used for entries added to the wait list. Suppose you want all
  8982.      `More (Y/n)?' prompts of the BBS login procedure to be skipped
  8983.      during your auto-login script. Then you would call `ADDITEM TO
  8984.      wait NAME "More (Y/n)?" RESPONSE "\r"', add the other keywords you
  8985.      would want to wait for and then finally call `WAIT'. Whenever the
  8986.      `More (Y/n)' prompt shows up the `WAIT' command will all by itself
  8987.      send the `\r' string (or in other words, the carriage return
  8988.      character) without exiting until the login string it was watching
  8989.      for is found. Please note that this feature only makes sense with
  8990.      the wait list but not with the `WAIT' command itself.
  8991.  
  8992.    * Added login learn mode controls. If the option is enabled in the
  8993.      dial panel incoming text and your responses to it will be recorded.
  8994.      When you are finished with your usual login procedure, call the
  8995.      `Record script' menu item in order to save the recorded data to an
  8996.      ARexx script. By default the recorder only watches for single
  8997.      keystrokes.  If you wish to enter an entire line use the `Record
  8998.      line' menu entry, calling this item a second time will transfer
  8999.      the line you entered into the recording buffer. Pressing the
  9000.      return key has the same effect. Pressing Shift+Return will also
  9001.      put you into line recording mode, no need to use the cryptic menu
  9002.      shortcut. Note: the `term' main menu now uses all available
  9003.      printable 7-bit ASCII characters for keyboard shortcuts :-(
  9004.  
  9005.    * Reworked the error reporting scheme, one of the weak spots of
  9006.      `term'. In previous releases you would be told that a file could
  9007.      not be saved or loaded, but no explanation would be given why the
  9008.      action failed. Where possible `term' will now tell you the cause
  9009.      of the error.
  9010.  
  9011.    * The printer support code was not particularly sensible to printer
  9012.      trouble, such as reported by the infamous printer.device requester.
  9013.      Even if this requester was cancelled `term' would happily continue
  9014.      to print, causing the printer trouble requester to pop up over and
  9015.      over again. This has been fixed.
  9016.  
  9017.    * The ARexx `DIAL' command is no longer synchronous by default,
  9018.      there is a new `SYNC' option which causes the ARexx script to wait
  9019.      until the dialer has made a connection/has failed to make a
  9020.      connection. The `RC' (result code variable) will be set to 5 if no
  9021.      connection was made, it will be 0 if a connection was made.  Now
  9022.      control can pass right through the `DIAL' command.
  9023.  
  9024.    * ARexx support is no longer a compile-time option but an integral
  9025.      part of the program.
  9026.  
  9027.    * Fixed a couple of bugs in the user interface library which dealt
  9028.      with odd alignment of slider level strings under v39. Some few
  9029.      strings still break the rules, but the results are less devastating
  9030.      than they used to be. Thankfully, most of the gadtools.library bugs
  9031.      that caused such trouble were fixed in v40.
  9032.  
  9033.    * Added the `trap' feature which implements the functionality of the
  9034.      ARexx wait list in an asynchronous fashion. For each sequence
  9035.      found a command sequence is executed. This should make it much
  9036.      easier to write UUCP scripts, BBS programs and such. Please note
  9037.      that the trap list is not identical to the wait list.
  9038.  
  9039.    * Rewrote the ARexx/AmigaDOS command execution routines which now
  9040.      execute their commands in truly asynchronous fashion, i.e. once
  9041.      their processes are spawned they keep to themselves and notify the
  9042.      main program when they are finished. This made it possible to
  9043.      remove the odd command handling workarounds and the special ARexx
  9044.      interface code that would take care of ARexx/AmigaDOS command
  9045.      execution.
  9046.  
  9047.    * The upload queue window code did not get the upload buttons
  9048.      enabled if icons were dropped on it.
  9049.  
  9050.    * The trap list loading code mixed up the order of commands and
  9051.      sequences, this has been fixed.
  9052.  
  9053.    * Fixed a monetary quantity formatting bug in the locale support
  9054.      code.
  9055.  
  9056.    * A malformed text formatting string was causing Enforcer hits in
  9057.      the action logging routine.
  9058.  
  9059.    * Added a few more `safety catches' to the screen opening code in
  9060.      order to make sure it does not open screens `too deep'.
  9061.  
  9062.    * Changing the screen size in the screen panel did not cause the
  9063.      screen to be reopened, this has been fixed.
  9064.  
  9065.    * Realized that it was not such a good idea to make most windows
  9066.      simple refresh and changed them to smart refresh. I've probably
  9067.      seen too many Macintosh programs forced to redraw their window
  9068.      contents over and over again.
  9069.  
  9070.    * The auto-upload panel now sports a button labeled `Upload from
  9071.      queue' which if enabled will cause the current upload queue to be
  9072.      transferred. Thanks to Bob Maple for pointing me into the right
  9073.      direction.
  9074.  
  9075.    * Fixed a truly nasty bug in the user interface code: integer type
  9076.      gadgets did not remember their original values when created, they
  9077.      would forget about them when queried and only would report them
  9078.      correctly when the values were changed. There is something I forgot
  9079.      to mention: integer gadgets understand hexadecimal (both 0x.. and
  9080.      $.. notation), binary (%..) and octal (&..) notation. The idea
  9081.      came from Martin Taillefer.
  9082.  
  9083.    * The date and time entries in log files are now printed in DOS
  9084.      format again.
  9085.  
  9086.    * Recorded scripts and such no longer include `\*SP' codes instead
  9087.      of plain spaces. This should improve readability.
  9088.  
  9089.    * With the `shared screen' feature enabled `term' would not respect
  9090.      the screen depth settings. This has been fixed.
  9091.  
  9092.    * The XPR routines no longer queue more than one IORequest, this
  9093.      should help to avoid trouble with some few device drivers.
  9094.  
  9095.    * The ARexx `QUIT' command really works now.
  9096.  
  9097.    * Removed the fixed-width font dependencies for Kickstart 2.04.
  9098.      Although windows may look funny if you use a proportional-spaced
  9099.      font, the program should deliver the same functionality as if it
  9100.      were using a fixed-width font.
  9101.  
  9102.    * Triggering the iconification function with the `Release serial
  9103.      device when iconified' option enabled will ask you for
  9104.      confirmation if the modem is still online.
  9105.  
  9106.    * Just for the fun of it added datatypes support. The IFF-ILBM saving
  9107.      routines of picture.datatype are used when saving the window
  9108.      contents to a file.
  9109.  
  9110.    * If the console output window specifier includes the `%s' string
  9111.      formatting parameter it will be replaced with the name of the
  9112.      public screen `term' resides upon.
  9113.  
  9114.    * New ARexx command `PROCESSIO' permits to turn off serial I/O
  9115.      processing by the main program. This will let ARexx programs
  9116.      receive & process all incoming data, without having `term' pull
  9117.      single strings from the input data stream.
  9118.  
  9119.    * Keymap strings to include null-bytes should be properly processed
  9120.      now, previous `term' releases would stop at the null-bytes and
  9121.      ignore the rest of the input lines.
  9122.  
  9123.    * Changes in the serial buffer size now cause the serial driver data
  9124.      to be updated as well.
  9125.  
  9126.    * Added facilities for external programs to rendezvous with `term',
  9127.      allowing them to take over the serial driver. This was added
  9128.      primarily to support my HydraCom Amiga port (please note that you
  9129.      need revision 2 of my HydraCom port to interface to `term'), but
  9130.      it may also help to support other file transfer protocols, such as
  9131.      the original rz/sz programs.
  9132.  
  9133.    * Whether trap list processing is enabled or not is now saved along
  9134.      with the trap list itself.
  9135.  
  9136.    * You can now lock the cursor keys and the numeric keypad separately.
  9137.  
  9138. Changes introduced with v3.4:
  9139. *****************************
  9140.  
  9141.    * Raised the maximum number of quick dial menu entries to 50.
  9142.  
  9143.    * Fixed a small bug connected with the text display screen.
  9144.  
  9145.    * XPR protocols which do not support batch transfers now work again
  9146.      as they did in v2.4.
  9147.  
  9148.    * Corrected a spelling mistake in the call logfile creation routine.
  9149.  
  9150.    * Fixed a memory allocation error in the review buffer code.
  9151.  
  9152.    * Fixed a major bug in the file transfer routines. In previous
  9153.      releases (say 3.1 and above) `term' used to throw invalid file
  9154.      locks around (seems I will have to use less ambiguous identifier
  9155.      names in the future...).
  9156.  
  9157.    * Fixed an Enforcer hit in the quick-dial menu creation.
  9158.  
  9159.    * Rarely, the program could fail to rebuild the quick-dial menu
  9160.      after leaving the phonebook.
  9161.  
  9162.    * As required by the specs, the XPR interface now switches baud
  9163.      rates and serial parameters.
  9164.  
  9165.    * Enhanced the capture functions.
  9166.  
  9167.    * Changed the user interface layout for some windows, such as the
  9168.      modem settings window.
  9169.  
  9170.    * When running on a public screen will no longer cause lockups and
  9171.      trouble with Workbench. Rendering errors are still possible.
  9172.  
  9173.    * The very first characters to follow a modem connect message are no
  9174.      longer quietly discarded.
  9175.  
  9176.    * Finally solved the truly mysterious case of the missing screen
  9177.      line.
  9178.  
  9179.    * Fixed yet another Enforcer hit in the packet window code.
  9180.  
  9181.    * The standard beep routine would not work.
  9182.  
  9183.    * Libraries and devices can now be selected using simple menus
  9184.      rather than the file requester.
  9185.  
  9186.    * The program now flushes capture files to disk every minute in
  9187.      order to insure that at least fragments of the captured session
  9188.      will be safe when disaster strikes.
  9189.  
  9190.    * Finally got the cross-hatch pattern to draw ghosted list views
  9191.      right.
  9192.  
  9193.    * The terminal hex mode would write too many bytes per line.
  9194.  
  9195.    * The program would not pay attention to any icon tool type settings.
  9196.  
  9197.    * Upon making a connection the dialing routine will no longer drop
  9198.      the line by accident.
  9199.  
  9200.    * The review buffer window will filter out unprintable characters
  9201.      before displaying text lines.
  9202.  
  9203.    * The program no longer knocks itself out if an initialization error
  9204.      occurs during the startup phase.
  9205.  
  9206.    * You can now select the name of the public screen the `term' window
  9207.      is to be opened upon using a menu.
  9208.  
  9209.    * If using a public screen the program will make use of the
  9210.      corresponding screen font and no longer try to modify it in any
  9211.      weird way.
  9212.  
  9213.    * The ARexx command `READ' did not pay attention to the translation
  9214.      table settings.
  9215.  
  9216.    * A configuration file to be loaded upon startup as specified using
  9217.      tooltypes or command line options will no longer be ignored.
  9218.  
  9219.    * The positions and sizes of certain program windows will be stored
  9220.      in the main configuration file.
  9221.  
  9222.    * Initially, when a file was received the information window would
  9223.      not display the space left on the output device.
  9224.  
  9225.    * Introduced the `time to connect' interval.
  9226.  
  9227.    * Added the serial read quantum.
  9228.  
  9229.    * The phonebook window will now be opened large enough to hold all
  9230.      its gadgets inside.
  9231.  
  9232.    * Blinking text display is no longer restricted to eight colour
  9233.      screens, provided the display architecture permits high-resolution
  9234.      screens in more than 4 bit planes.
  9235.  
  9236.    * The program now exists cleanly if vital resources such as the
  9237.      output screen cannot be opened.
  9238.  
  9239.    * The file transfer routines should run a tiny little bit faster now.
  9240.  
  9241.    * Added the transfer performance meter.
  9242.  
  9243.    * The clear screen control sequence now optionally resets the cursor
  9244.      position.
  9245.  
  9246.    * Rarely, the text buffer screen would not update the first text
  9247.      line properly. Also, the screen display mode will no longer fall
  9248.      back to HIRES/HIRES_INTERLACED.
  9249.  
  9250.    * Rarely, the review buffer window would render text in the wrong
  9251.      colours.
  9252.  
  9253.    * The pen/palette sharing code was submitting incorrect colour codes.
  9254.  
  9255.    * The review buffer window now responds to the same keypresses as
  9256.      the text buffer screen and the main input window.
  9257.  
  9258.    * Not all packet menu items were to be invoked using menu shortcuts.
  9259.  
  9260.    * Added `Completion time' display to the transfer progress window.
  9261.  
  9262.    * Introduced special transfer library settings. You can now select
  9263.      which library to use for ASCII, text or binary transfers.
  9264.  
  9265.    * Added built-in ASCII transfer routines.
  9266.  
  9267.    * You can now search forwards or backwards through the text buffer.
  9268.  
  9269.    * Text stored in the buffer no longer gets trailing spaces stripped
  9270.      in order to keep weird uuencoded data intact.
  9271.  
  9272.    * The menu items featured in the `Edit' menu now properly reflect
  9273.      the state of the clipboard.
  9274.  
  9275.    * A menu shortcut would be used twice in the main window menus.
  9276.  
  9277.    * Rarely, the colour choices for the bar charts in the transfer
  9278.      progress window would be wrong.
  9279.  
  9280.    * The quick dial menu would not be rebuilt if the phonebook was
  9281.      sorted or new entries were added.
  9282.  
  9283.    * The ARexx commands `DELAY' and `SEND' would not turn off the text
  9284.      cursor prior to text processing.
  9285.  
  9286.    * Unless it is absolutely necessary, the text display scope is no
  9287.      longer moved automatically.
  9288.  
  9289.    * As for the text display screen and window the `Alt' keys now have
  9290.      the same effect as the `Control' key.
  9291.  
  9292.    * If new text is added to the text buffer the buffer screen and the
  9293.      review window are properly updated now.
  9294.  
  9295.    * A dialing list built using the quick dial menu was not enumerated
  9296.      properly.
  9297.  
  9298.    * Building a dialing list using the quick dial menu via extended
  9299.      selection, then selecting the phonebook control panel, clearing
  9300.      the dialing list and leaving the phonebook will no longer start
  9301.      dialing the list just cleared.
  9302.  
  9303.    * Checkmarks now indicate which entries in the quick dial menu are to
  9304.      be dialed.
  9305.  
  9306.    * The bar charts displayed in the transfer progress window are now
  9307.      updated in a more efficient manner (the text colour has changed,
  9308.      too).  Also, unzooming the window will properly update the bar
  9309.      charts now.
  9310.  
  9311.    * A hardware buffer overrun error is no longer considered a fatal
  9312.      error.
  9313.  
  9314.    * With some requesters and windows string gadgets are auto-activated
  9315.      now. Pressing the `Return' key will cycle through all the available
  9316.      strings gadgets, holding down either `Shift' key will break the
  9317.      cycle.
  9318.  
  9319.    * Trying to quit the program will no longer ask for confirmation if
  9320.      there is no reasons to ask for.
  9321.  
  9322.    * The bar charts in the transfer progress window will be omitted if
  9323.      the remaining screen space would not permit the entire window to be
  9324.      displayed.
  9325.  
  9326.    * The fast! macro window contents would be rendered in the wrong
  9327.      colours.
  9328.  
  9329.    * The phonebook window did not support any online-help features.
  9330.  
  9331. Changes introduced with v3.3:
  9332. *****************************
  9333.  
  9334.    * Added the quick dialing menu.
  9335.  
  9336.    * Enhanced the modem and screen settings
  9337.  
  9338.    * Fixed a few bugs in the ARexx interface commands `REQUESTFILE' and
  9339.      `REQUESTRESPONSE'
  9340.  
  9341.    * Unfortunately a single line was missing in the XPR option setup,
  9342.      causing them program not to save the transfer protocol options.
  9343.  
  9344.    * No longer forces the creation date of an auto-capture file to be
  9345.      included in the file. As an option, will use the naming convention
  9346.      used in previous program releases.
  9347.  
  9348.    * The program now optionally creates icons for files.
  9349.  
  9350.    * Added a terminal hex-mode for debugging purposes
  9351.  
  9352.    * Fonts are now opened using properly initialized DPI and aspect
  9353.      ratio values which results in much better scaled outline font
  9354.      rendering.
  9355.  
  9356.    * The name of an external emulation library is no longer quietly
  9357.      suppressed.
  9358.  
  9359.    * It is possible to disable the double-buffered file management
  9360.      routines now.
  9361.  
  9362.    * Added the text pacing option.
  9363.  
  9364.    * Apparently, external and internal terminal emulations tried to
  9365.      turn on/off each other's cursors.
  9366.  
  9367.    * Copying text to the clipboard now permits to append the text to
  9368.      the current clipboard contents.
  9369.  
  9370. Changes introduced with v3.2:
  9371. *****************************
  9372.  
  9373.    * Could not enter phonebook passwords
  9374.  
  9375.    * The XPR interface now states much more clearly what the likely
  9376.      cause of a serial I/O error might have been
  9377.  
  9378.    * New sound support functions added
  9379.  
  9380.    * Added `OK' and `ERROR' modem response codes
  9381.  
  9382.    * The order of messages displayed in the file transfer window has
  9383.      changed (now works top down rather than bottom up).
  9384.  
  9385.    * The ARexx interface routines did not check whether the serial
  9386.      device handles were available or not (boom!)
  9387.  
  9388.    * Redid the fast! macro handling
  9389.  
  9390.    * The text buffer screen did not notice when the buffer contents
  9391.      were cleared
  9392.  
  9393.    * Retuned the phonebook and dial list routines which could generate
  9394.      Enforcer hits and trash innocent memory
  9395.  
  9396.    * Boldface/italics characters will no longer leak into the window
  9397.      borders
  9398.  
  9399.    * The cursor image now reflects the state of the terminal window
  9400.  
  9401.    * The program would generate an Enforcer hit when files were to be
  9402.      transferred by dropping their icons on the main window
  9403.  
  9404.    * When opening a capture file the program could ask twice whether an
  9405.      already existing file should be replaced.
  9406.  
  9407.    * Paste operations triggered from the review buffer window would not
  9408.      start any paste operation until the main window was reselected
  9409.  
  9410.    * Reworked the character translation table format.  Translation
  9411.      table files should be smaller now and should load a lot faster
  9412.  
  9413.    * The screen/output window size now changes to the number of columns
  9414.      specified in the terminal settings
  9415.  
  9416.    * Rarely, the file transfer window would be opened very narrow and
  9417.      tall.  So tall in fact that display elements would overlap each
  9418.      other, no text could be displayed in the big listview and Enforcer
  9419.      hits were not to be avoided.
  9420.  
  9421.    * The file transfer interface would produce Enforcer hits when to
  9422.      transfer files using an old-style XPR library.
  9423.  
  9424.    * The phonebook dial list handling would select single entries when
  9425.      a shift key was pressed during keyboard selection.
  9426.  
  9427.    * The review buffer window no longer loses track of the text area it
  9428.      ought to display after resizing the window.
  9429.  
  9430.    * Rewrote much of the keyboard/mouse/peanut butter handling loop.
  9431.      No longer quite so complex.
  9432.  
  9433.    * Thanks to user persistence the `Password' text entry field
  9434.      available through the password/user panel no longer hides the
  9435.      actual password text.
  9436.  
  9437.    * `Hang up' menu item did not cause a backed-up configuration to be
  9438.      restored.
  9439.  
  9440.    * Naughty XPR protocols which would issue error reports through
  9441.      xpr_update() during XPRSetup() would cause the transfer window to
  9442.      be opened not to close afterwards.
  9443.  
  9444.    * No more odd happenings in the status line online time display.
  9445.      The code responsible would misinterprete a string index.  This has
  9446.      been fixed.
  9447.  
  9448.    * It is no longer possible to dial phonebook entries which have no
  9449.      name or phone number attached.
  9450.  
  9451.    * The terminal emulation code no longer leaves background colour
  9452.      artifacts when scrolling text with a background colour other than
  9453.      the default background colour enabled.
  9454.  
  9455.    * Calls to BeginIO() rather than SendIO() were giving some - if not
  9456.      most - device drivers hard times.  According to the few tests I
  9457.      have run so far the program now performs more reliable when doing
  9458.      file transfers.  `term' now works again in conjunction with
  9459.      isdn.device.
  9460.  
  9461.    * The program no longer encodes the creation date into the name of an
  9462.      auto-capture file but rather writes creation time and date to the
  9463.      first new line in the file.
  9464.  
  9465.    * New tooltype/command line option `Quiet' will cause `term' to
  9466.      start up iconified.
  9467.  
  9468. Changes introduced with v3.1:
  9469. *****************************
  9470.  
  9471.    * Previous releases of the phonebook would not clone single phonebook
  9472.      entries correctly.
  9473.  
  9474.    * The configuration copying routine will now selectively copy config
  9475.      information to the currently selected phonebook entries.
  9476.  
  9477.    * The phonebook encryption/decryption routines are a tad faster now.
  9478.  
  9479.    * The program will now prompt twice for a phonebook access password.
  9480.  
  9481.    * Comment, phone number, user name and password can be much longer
  9482.      now than they used to be in previous releases.
  9483.  
  9484.    * The phonebook now only contains the configuration information to
  9485.      differ from the global configuration.
  9486.  
  9487.    * Previous releases would not save any rate information along with
  9488.      encrypted phonebook files, this has been fixed.
  9489.  
  9490.    * The configuration copying routine now allows to `drop' parts of
  9491.      the phone book configuration rather than replacing them with parts
  9492.      of the global configuration.  This feature works in conjunction
  9493.      with the new phonebook file format.
  9494.  
  9495.    * A new feature has been added:  as an option, the program will
  9496.      immediately start to redial the currently configured dialing list
  9497.      as soon as the line is hung up or the carrier is lost.
  9498.  
  9499.    * The program finally includes context-sensitive online help
  9500.      implemented through amigaguide.library (note:  Kickstart 3.0
  9501.      required).  Any window to offer a help text will display it when
  9502.      the `Help' key is pressed.
  9503.  
  9504.    * The ARexx interface documentation was entirely rewritten.  The
  9505.      main program documentation was updated and slightly enhanced.  Be
  9506.      sure to reread it!
  9507.  
  9508.    * Both the text buffer screen and review buffer window now feature
  9509.      new and improved scrollers.  Scrolling and screen refreshes are
  9510.      also quite a bit faster now.
  9511.  
  9512.    * The text searching routine has been enhanced and now works much
  9513.      faster than in previous releases.  It also happens to find
  9514.      multiple occurences of a string in a single line.
  9515.  
  9516.    * Improved text buffer handling, reduced memory fragmentation if
  9517.      running under control of Kickstart 3.0.
  9518.  
  9519.    * The text buffer will no longer quietly swallow single characters
  9520.      and will finally correctly wrap lines longer than 80 characters.
  9521.  
  9522.    * The review buffer window now also sports a search function just
  9523.      like the text buffer screen, other useful menu items have been
  9524.      added as well.
  9525.  
  9526.    * In previous releases the program would miscalculate the number of
  9527.      bytes left on a filing device when receiving a file.  It would not
  9528.      take the number of bytes received into account, this has been
  9529.      fixed.
  9530.  
  9531.    * In order to transfer files one can simply drag the corresponding
  9532.      icons on the `term' main window (requires that the `term' window
  9533.      is opened on the Workbench screen).
  9534.  
  9535.    * Instead of identifying the type of a file received, the program
  9536.      will optionally attach a file comment to show the name of the BBS
  9537.      the file was received from and the time and date when the file was
  9538.      received.
  9539.  
  9540.    * In case a file transfer is terminated due to errors the file
  9541.      transfer window will remain open until explicitely closed.
  9542.  
  9543.    * The XPR interface will disable the xpr_unlink() routine if the
  9544.      `override transfer path' option is in effect.
  9545.  
  9546.    * The XPR interface will no longer sort files to be uploaded by size
  9547.      and name as most users found this feature annoying.  It now sorts
  9548.      the files by name.
  9549.  
  9550.    * The file transfer window now correctly displays the names of all
  9551.      files sent and received.
  9552.  
  9553.    * The file transfer server was removed as it would not lead to a
  9554.      performance gain but a performance loss.
  9555.  
  9556.    * `term' now finally also runs as a window on the Workbench or any
  9557.      other public screen (that's what you always wanted, right?).  If
  9558.      running under control of Kickstart 3.0 will attempt to share
  9559.      screen colours with other applications, making it possible to run
  9560.      the terminal emulation in eight or sixteen colours if enough
  9561.      shareable pens are available.
  9562.  
  9563.    * `term' will refuse to run on a public screen if running under
  9564.      control of Kickstart 2.x and if the screen font happens to be
  9565.      proportional-spaced.
  9566.  
  9567.    * Some minor and some major bugs in the built-in terminal emulation
  9568.      have been fixed.
  9569.  
  9570.    * The program distribution now includes the 11 point IBM.font
  9571.      donated by Bernhard F.  Muller.
  9572.  
  9573.    * I was surprised to discover that in previous releases the terminal
  9574.      emulation server would never get activated as the conditions it
  9575.      would be enabled would very rarely be met.  Since the file
  9576.      transfer server would actually lead to a performance loss rather
  9577.      than a performance gain I chose to remove the terminal server
  9578.      along with it.  Both may be implemented in a future release.
  9579.  
  9580.    * The terminal emulation should work a tad faster now.
  9581.  
  9582.    * The program now requires diskfont.library to be installed in order
  9583.      to work correctly.
  9584.  
  9585.    * The program will ask for a confirmation prior to resetting the
  9586.      serial device driver while the program is still online.  Most
  9587.      seasoned JR-Comm had trouble to adjust to the fact that the
  9588.      JR-Comm command `send password' would use the same menu shortcut
  9589.      as the `term'?`release serial device' command.
  9590.  
  9591.    * The name of the call log file can now be configured completely.
  9592.      Previous releases would use the call file path and use the name
  9593.      `term-call.log'.
  9594.  
  9595.    * The status window now displays the name of the ARexx host port,
  9596.      the BBS name, phone number, comment and current user name.
  9597.  
  9598.    * In order to confuse and annoy you, the menu layout has been
  9599.      changed once again.
  9600.  
  9601.    * A new feature has been added:  the `wait' menu item will
  9602.      repeatedly send the sequence <Space><Backspace> in order to
  9603.      simulate terminal input.
  9604.  
  9605.    * The program now requires a bit more memory than before (program
  9606.      size has climbed by about 50 KBytes).
  9607.  
  9608.    * New command line options and tool types have been added, some have
  9609.      been renamed.
  9610.  
  9611.    * The program is now much smarter in determining the sizes of the
  9612.      phonebook and file transfer window.
  9613.  
  9614.    * The lists used by the phonebook and the date panel no longer look
  9615.      quite so weird if using a proportional-spaced font.
  9616.  
  9617.    * The main screen text snipping scheme has changed a bit and now
  9618.      resembles the standard console device snipping.  Also supported is
  9619.      double-clicking on single words in order to snip them.
  9620.  
  9621.    * The ARexx interface has been entirely rewritten from scratch.
  9622.